# Screener.in Scraper (`solidcode/screener-in-scraper`) Actor

\[💰 $8 / 1K] Extract Indian stock fundamentals from Screener.in — ratios, quarterly results, P\&L, balance sheet, cash flow, shareholding, and peers. Run named public screens by URL. No login required.

- **URL**: https://apify.com/solidcode/screener-in-scraper.md
- **Developed by:** [SolidCode](https://apify.com/solidcode) (community)
- **Categories:** Developer tools, Automation, Other
- **Features:** Limited permissions
- **Stats:** 101 total users, 17 monthly users, 100.0% runs succeeded, 1 bookmarks
- **User rating**: 5.00 out of 5 stars

## Pricing

from $8.00 / 1,000 results

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## Screener.in Scraper

Pull structured company fundamentals and stock-screen results from Screener.in at scale — current price, market cap, key ratios, and a full historical financial stack (quarterly results, profit & loss, balance sheet, cash flow, efficiency ratios, shareholding pattern, and peer comparison) for any NSE/BSE-listed Indian company. Built for equity analysts, quant researchers, and fintech builders who need a clean, machine-readable Indian-market fundamentals dataset without copy-pasting tables out of Screener.in one company at a time.

### Why This Scraper?

- **Seven financial sections per company** — quarterly results, profit & loss, balance sheet, cash flow, efficiency ratios, shareholding pattern, and peer comparison, each toggleable so you pull only the sections you need.
- **Deep history, not just a snapshot** — roughly 13 quarters of results and about 12 years of annual P\&L, balance sheet, cash flow, and ratios per company, ready for time-series analysis.
- **Consolidated AND standalone financials** — switch between group-wide and parent-only numbers, or mix both in one run by pointing at the matching company URLs.
- **Key ratios parsed into clean numbers** — P/E, ROCE, ROE, dividend yield, book value, face value, 52-week high/low, market cap, and current price, each delivered as both the raw label and a parsed numeric value.
- **Two ownership series per company** — a ~12-quarter and a ~11-year shareholding history side by side: FII, DII, public and government stakes plus the total shareholder count on every period, with promoter and "others" splits where the issuer reports them.
- **Peer comparison rows** — the sector cohort Screener.in shows for each company, with CMP, P/E, market cap, dividend yield, and ROCE for every peer.
- **Public screens, no login** — paste any named Screener.in screen URL (e.g. `/screens/343087/fii-buying/`) and get every matching company with that screen's metric columns, paged across all result pages.
- **Indian number formatting handled for you** — `4,52,320` lakh-style commas, `₹`/`Cr`/`%` decoration, and parenthesised negatives are normalised into plain floats you can compute on directly.
- **Batch symbols and URLs together** — feed plain tickers (`INFY`, `TCS`), full company URLs, and screen URLs in a single run; the scraper auto-detects each one.

### Use Cases

**Equity Research & Valuation**

- Build a one-row-per-company fundamentals snapshot across a watchlist
- Pull 12 years of P\&L and balance sheet history for DCF and ratio models
- Compare consolidated vs standalone numbers for holding-company analysis

**Quant & Backtesting Datasets**

- Assemble structured fundamentals panels for factor research
- Extract quarterly results time series for earnings-momentum signals
- Track ROCE, ROE, and debtor/inventory days trends across years

**Fintech & Portfolio Apps**

- Power a stock-detail screen with prices, ratios, and shareholding
- Refresh portfolio holdings with current price and market cap
- Surface peer comparison tables inside your own product

**Financial Journalism & Newsletters**

- Source numbers for company deep-dives and earnings write-ups
- Track promoter and FII/DII shareholding shifts quarter over quarter
- Pull a public screen of movers to seed a market roundup

**Competitive & Peer Analysis**

- Benchmark a company against its Screener.in sector cohort
- Rank companies in a named screen by any metric column
- Map institutional ownership across a basket of stocks

### Getting Started

#### Single Company

The simplest run — one symbol, the full fundamentals record:

```json
{
    "companies": ["INFY"]
}
```

#### Standalone Financials, Fewer Sections

Pull parent-only numbers and just the sections you care about for a leaner, faster result:

```json
{
    "companies": ["TCS", "RELIANCE"],
    "financialsType": "standalone",
    "includeSections": ["quarterlyResults", "profitLoss", "peers"]
}
```

#### A Public Screen, Capped

Run a named public screen and cap how many matching companies you pull:

```json
{
    "screenUrls": ["https://www.screener.in/screens/343087/fii-buying/"],
    "maxResults": 50
}
```

#### Companies and a Screen Together

Mix individual companies and a screen in one run — each company yields a full record, each screen match yields a row:

```json
{
    "companies": ["INFY", "https://www.screener.in/company/HDFCBANK/consolidated/"],
    "screenUrls": ["https://www.screener.in/screens/343087/fii-buying/"],
    "financialsType": "consolidated",
    "includeSections": ["quarterlyResults", "profitLoss", "balanceSheet", "cashFlow", "ratios", "shareholding", "peers"],
    "maxResults": 100
}
```

### Input Reference

#### What to Scrape

| Parameter | Type | Default | Description |
|-----------|------|---------|-------------|
| `companies` | string\[] | `["INFY"]` | Company symbols (e.g. `INFY`, `RELIANCE`, `TCS`) or full Screener.in company URLs. Each one returns a full company record with ratios and financials. Leave empty if you only want to run screens. |
| `screenUrls` | string\[] | `[]` | Public screen URLs (e.g. `https://www.screener.in/screens/343087/fii-buying/`). Each returns the list of matching companies with the screen's columns. No account needed. |

#### Company Options

These apply only to the `companies` list, not to screens.

| Parameter | Type | Default | Description |
|-----------|------|---------|-------------|
| `financialsType` | select | `Consolidated (group-wide)` | Whether to pull `Consolidated (group-wide)` or `Standalone (parent only)` financials. Ignored for any company URL that already specifies this in its path. |
| `includeSections` | multi-select | all selected | Which financial sections to include per company: Quarterly Results, Profit & Loss (annual), Balance Sheet, Cash Flow, Financial Ratios, Shareholding Pattern, Peer Comparison. Company overview and key ratios are always included. Select fewer for a leaner, faster result. |

#### Screen Options

| Parameter | Type | Default | Description |
|-----------|------|---------|-------------|
| `maxResults` | integer | `100` | Maximum matching companies to return per screen. Set to `0` for all available pages. Does not limit the `companies` list. Start with 25–50 to test, then increase. |

### Output

Every row carries a `recordType` field — `company` or `screenResult` — so you can filter the two cleanly downstream. `null` fields are dropped before output, so a record only contains the sections you requested.

#### Company (`recordType: "company"`)

```json
{
    "recordType": "company",
    "symbol": "INFY",
    "name": "Infosys Ltd",
    "url": "https://www.screener.in/company/INFY/consolidated/",
    "financialsType": "consolidated",
    "about": "Infosys Ltd provides consulting, technology, outsourcing and next-generation digital services...",
    "website": "http://www.infosys.com",
    "bseCode": "500209",
    "nseCode": "INFY",
    "currentPrice": 1036.0,
    "marketCapCr": 420636.0,
    "keyRatios": {
        "marketCap": { "raw": "₹ 4,20,636 Cr.", "value": 420636.0 },
        "currentPrice": { "raw": "₹ 1,036", "value": 1036.0 },
        "highLow": { "raw": "₹ 1,728 / 982", "value": 1728.0 },
        "pe": { "raw": "13.5", "value": 13.5 },
        "bookValue": { "raw": "₹ 225", "value": 225.0 },
        "dividendYield": { "raw": "4.63 %", "value": 4.63 },
        "roce": { "raw": "40.0 %", "value": 40.0 },
        "roe": { "raw": "31.9 %", "value": 31.9 },
        "faceValue": { "raw": "₹ 5.00", "value": 5.0 }
    },
    "quarterlyResults": [
        { "period": "2026-06-30", "sales": { "raw": "48,211", "value": 48211.0 }, "operatingProfit": { "raw": "11,409", "value": 11409.0 }, "netProfit": { "raw": "7,775", "value": 7775.0 }, "epsIn": { "raw": "19.15", "value": 19.15 } }
    ],
    "profitLoss": [
        { "period": "2026-03-31", "sales": { "raw": "178,650", "value": 178650.0 }, "netProfit": { "raw": "29,474", "value": 29474.0 }, "dividendPayout": { "raw": "66%", "value": 66.0 } }
    ],
    "shareholding": [
        { "period": "Jun 2026", "promoters": { "raw": "13.82%", "value": 13.82 }, "fiis": { "raw": "27.09%", "value": 27.09 }, "diis": { "raw": "42.78%", "value": 42.78 }, "government": { "raw": "0.20%", "value": 0.2 }, "public": { "raw": "15.88%", "value": 15.88 }, "others": { "raw": "0.21%", "value": 0.21 }, "noOfShareholders": { "raw": "29,58,297", "value": 2958297.0 } }
    ],
    "shareholdingYearly": [
        { "period": "Mar 2026", "promoters": { "raw": "14.38%", "value": 14.38 }, "fiis": { "raw": "28.45%", "value": 28.45 }, "diis": { "raw": "43.19%", "value": 43.19 }, "government": { "raw": "0.20%", "value": 0.2 }, "public": { "raw": "13.54%", "value": 13.54 }, "others": { "raw": "0.23%", "value": 0.23 }, "noOfShareholders": { "raw": "27,48,596", "value": 2748596.0 } }
    ],
    "peers": [
        { "name": "TCS", "symbol": "TCS", "url": "https://www.screener.in/company/TCS/consolidated/", "rank": 1, "metrics": { "currentPrice": { "raw": "2204.10", "value": 2204.1, "label": "Current Price" }, "priceToEarning": { "raw": "14.85", "value": 14.85, "label": "Price to Earning" } } }
    ],
    "scrapedAt": "2026-09-10T19:12:19+00:00"
}
```

##### Core Fields

| Field | Type | Description |
|-------|------|-------------|
| `recordType` | string | Always `"company"` |
| `symbol` | string | NSE/BSE symbol (e.g. `INFY`) |
| `name` | string | Company name (e.g. `Infosys Ltd`) |
| `url` | string | Source Screener.in company URL |
| `financialsType` | string | `consolidated` or `standalone` |
| `about` | string | Business description blurb |
| `website` | string | Company website link |
| `bseCode` | string | BSE security code |
| `nseCode` | string | NSE symbol |
| `scrapedAt` | string | ISO 8601 timestamp of extraction |

##### Pricing & Key Ratios

| Field | Type | Description |
|-------|------|-------------|
| `currentPrice` | number | Current market price in ₹ |
| `marketCapCr` | number | Market capitalisation in ₹ crore |
| `keyRatios` | object | Map of headline ratios — `marketCap`, `currentPrice`, `pe`, `bookValue`, `dividendYield`, `roce`, `roe`, `faceValue`, `highLow` and more. Each value is `{ raw, value }`. |

##### Financial Statements

Each is an array of one row per period (newest history included), present only when requested in `includeSections`.

| Field | Type | Description |
|-------|------|-------------|
| `quarterlyResults` | object\[] | ~13 quarters — `period` plus sales, expenses, operating profit, OPM%, profit before tax, net profit, EPS, etc. |
| `profitLoss` | object\[] | ~12 years of annual profit & loss |
| `balanceSheet` | object\[] | ~12 years — equity, reserves, borrowings, fixed assets, investments, other assets |
| `cashFlow` | object\[] | ~12 years — operating, investing, financing, and net cash flow |
| `ratios` | object\[] | ~12 years of efficiency ratios — debtor days, inventory days, payable days, cash conversion cycle, working capital days, ROCE% |

Each metric inside a period row is a `{ raw, value }` pair, so you get both Screener.in's formatted string and a parsed float.

##### Shareholding & Peers

| Field | Type | Description |
|-------|------|-------------|
| `shareholding` | object\[] | Quarterly ownership series (~12 quarters), one row per `period` (`Jun 2026` style). Carries `fiis`, `diis`, `public`, `government` and `noOfShareholders`, plus `promoters` and `others` where the company reports them — professionally managed banks and conglomerates with no identifiable promoter have no promoter row at source. |
| `shareholdingYearly` | object\[] | Yearly ownership series (~11 years) for the same company — identical fields to `shareholding`, its own `period` labels. Ships alongside `shareholding` whenever the Shareholding Pattern section is selected. |
| `peers` | object\[] | Sector peer cohort — each peer has `name`, `symbol`, `url`, `rank`, and a `metrics` map (CMP, P/E, market cap, dividend yield, ROCE, etc.) |

#### Screen Result (`recordType: "screenResult"`)

One row per company matched by a screen. The `metrics` map mirrors that screen's own columns, so it varies from screen to screen.

```json
{
    "recordType": "screenResult",
    "screenUrl": "https://www.screener.in/screens/343087/fii-buying/",
    "screenName": "FII Buying",
    "rank": 1,
    "name": "Billionbrains",
    "symbol": "GROWW",
    "url": "https://www.screener.in/company/GROWW/consolidated/",
    "metrics": {
        "currentPrice": { "raw": "195.84", "value": 195.84, "label": "Current Price" },
        "priceToEarning": { "raw": "50.37", "value": 50.37, "label": "Price to Earning" },
        "marketCapitalization": { "raw": "122881.06", "value": 122881.06, "label": "Market Capitalization" },
        "changeInFiiHolding": { "raw": "4.38", "value": 4.38, "label": "Change in FII holding" },
        "fiiHolding": { "raw": "6.89", "value": 6.89, "label": "FII holding" }
    },
    "scrapedAt": "2026-09-10T19:09:57+00:00"
}
```

| Field | Type | Description |
|-------|------|-------------|
| `recordType` | string | Always `"screenResult"` |
| `screenUrl` | string | Source screen URL |
| `screenName` | string | Screen title (e.g. `FII Buying`) |
| `rank` | number | Row position within the screen |
| `name` | string | Company name |
| `symbol` | string | Company symbol / link slug |
| `url` | string | Company page URL on Screener.in |
| `metrics` | object | Map of the screen's displayed columns, keyed by metric — each value is `{ raw, value, label }`, where `label` is Screener.in's full metric name (`Current Price`, `Price to Earning`, `Market Capitalization`) rather than the abbreviated column heading |
| `scrapedAt` | string | ISO 8601 timestamp of extraction |

### Tips for Best Results

- **Trim `includeSections` for speed.** Company overview and key ratios are always included — if you only need quarterly results and peers, deselect the rest for a leaner, quicker record.
- **Symbols are easier than URLs.** Typing `INFY` or `RELIANCE` is more reliable than pasting a full company URL — the scraper builds the right consolidated or standalone link for you.
- **A company URL overrides `financialsType`.** If a URL already ends in `/consolidated/` or `/standalone/`, that wins for that company — so you can request a mix of both in a single run regardless of the global setting.
- **Use named public screen URLs, not custom queries.** Free-text screen queries (e.g. `Market Capitalization > 50000`) require a Screener.in login and aren't supported; paste a named public screen URL like `/screens/343087/fii-buying/` instead. Unsupported screen inputs are skipped with a clear message rather than failing the run.
- **Cap large screens with `maxResults`.** A popular screen can run to hundreds of companies and every row is charged — start at 25–50 to confirm the columns you want, then raise it (or set `0` for everything).
- **Mix companies and screens in one run.** Pay for a single start and pull both your watchlist's full fundamentals and a screen of new candidates together.
- **Two period formats, both `raw` and `value`.** Financial statements are keyed by ISO date (`2026-03-31`, plus a `TTM` column on profit & loss), while shareholding periods read `Jun 2026`. Every metric carries `value` for math and charts and `raw` for Screener.in's exact ₹/%/crore formatting.

### Pricing

**From $8.00 per 1,000 results** — flat pay-per-result for fully structured Indian-market fundamentals, with no login or account ever required. No compute or time-based charges — you pay per result, plus a small fixed per-run start fee. Bronze, Silver, and Gold subscribers pay progressively less; the table below shows total cost at each discount tier.

| Results | No discount | Bronze | Silver | Gold |
|---------|-------------|--------|--------|------|
| 100 | $0.96 | $0.91 | $0.85 | $0.80 |
| 1,000 | $9.60 | $9.05 | $8.50 | $8.00 |
| 10,000 | $96.00 | $90.50 | $85.00 | $80.00 |
| 100,000 | $960.00 | $905.00 | $850.00 | $800.00 |

A "result" is any row in the output dataset — one `company` record or one `screenResult` row. Platform fees (compute, storage) are additional and depend on your Apify plan.

### Integrations

Export data in JSON, CSV, Excel, XML, or RSS. Connect to 1,500+ apps via:

- **Zapier** / **Make** / **n8n** — Workflow automation
- **Google Sheets** — Direct spreadsheet export
- **Slack** / **Email** — Notifications on new results
- **Webhooks** — Trigger custom APIs on run completion
- **Apify API** — Full programmatic access

### Legal & Ethical Use

This actor is designed for legitimate financial research, investment analysis, and market intelligence using publicly available company information. Users are responsible for complying with applicable laws and Screener.in's terms of service, including making reasonable-rate requests. Data is provided for informational purposes only and is not investment advice. Do not use extracted data for spam, harassment, or any illegal purpose.
</content>
</invoke>

# Actor input Schema

## `companies` (type: `array`):

Company symbols (e.g. 'INFY', 'RELIANCE', 'TCS') or full Screener.in company URLs (e.g. 'https://www.screener.in/company/INFY/'). Each one returns a full company record with ratios and financials. Leave empty if you only want to run screens.

## `screenUrls` (type: `array`):

Named public screen URLs only, in the form 'https://www.screener.in/screens/{id}/{slug}/' (e.g. 'https://www.screener.in/screens/343087/fii-buying/'). Each returns the list of matching companies with the screen's columns. No account needed. Free-text queries (e.g. 'Market Capitalization > 50000') need a Screener.in login and are skipped — open the screen in Screener.in, save it, and paste its public URL instead.

## `financialsType` (type: `string`):

Whether to pull consolidated (group-wide) or standalone (parent company only) financials. Ignored for any company URL that already specifies this.

## `includeSections` (type: `array`):

Which financial sections to include for each company. Company overview and key ratios are always included. Select fewer sections for a leaner, faster result.

## `maxResults` (type: `integer`):

Maximum number of matching companies to return per screen. Set to 0 for all available pages (up to a generous safety ceiling of 500 pages). This does not limit the Companies list. Tip: start with 25-50 to test, then increase.

## Actor input object example

```json
{
  "companies": [
    "INFY"
  ],
  "screenUrls": [],
  "financialsType": "consolidated",
  "includeSections": [
    "quarterlyResults",
    "profitLoss",
    "balanceSheet",
    "cashFlow",
    "ratios",
    "shareholding",
    "peers"
  ],
  "maxResults": 100
}
```

# Actor output Schema

## `overview` (type: `string`):

Table of companies and screen results with key metrics.

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "companies": [
        "INFY"
    ],
    "screenUrls": [],
    "financialsType": "consolidated",
    "includeSections": [
        "quarterlyResults",
        "profitLoss",
        "balanceSheet",
        "cashFlow",
        "ratios",
        "shareholding",
        "peers"
    ],
    "maxResults": 100
};

// Run the Actor and wait for it to finish
const run = await client.actor("solidcode/screener-in-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "companies": ["INFY"],
    "screenUrls": [],
    "financialsType": "consolidated",
    "includeSections": [
        "quarterlyResults",
        "profitLoss",
        "balanceSheet",
        "cashFlow",
        "ratios",
        "shareholding",
        "peers",
    ],
    "maxResults": 100,
}

# Run the Actor and wait for it to finish
run = client.actor("solidcode/screener-in-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "companies": [
    "INFY"
  ],
  "screenUrls": [],
  "financialsType": "consolidated",
  "includeSections": [
    "quarterlyResults",
    "profitLoss",
    "balanceSheet",
    "cashFlow",
    "ratios",
    "shareholding",
    "peers"
  ],
  "maxResults": 100
}' |
apify call solidcode/screener-in-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,solidcode/screener-in-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/k7b8yj2M7isEr8mCY/builds/irMS6hZIuZhLXbzVN/openapi.json