TradingView Screener Scraper

Export structured stock, cryptocurrency, and forex screener data from TradingView into a clean Apify dataset. Filter and sort public market instruments, request specific symbols, and preserve selected technical columns for analysis.

Who is it for?

This Actor is for analysts, developers, researchers, and automation teams that need repeatable market-screener exports without manual copy-and-paste work.

What you can do

• Build stock, crypto, or forex watchlists
• Rank instruments by market capitalization, volume, price, change, RSI, or recommendation
• Export selected symbols such as NASDAQ:AAPL
• Apply numeric filters before export
• Add supported performance, valuation, dividend, volatility, and 52-week columns
• Download results as JSON, CSV, Excel, XML, or RSS and use them through the Apify API

Input example

{
  "markets": ["america"],
  "maxItems": 100,
  "sortBy": "market_cap_basic",
  "sortOrder": "desc",
  "filters": [
    { "field": "volume", "operation": "greater", "value": 1000000 }
  ],
  "customColumns": ["Perf.W", "Perf.1M", "High.52W", "Low.52W"]
}

Output example

{
  "symbol": "NASDAQ:AAPL",
  "ticker": "AAPL",
  "name": "Apple Inc.",
  "description": "Apple Inc.",
  "exchange": "NASDAQ",
  "market": "america",
  "type": "stock",
  "country": "United States",
  "sector": "Electronic Technology",
  "industry": "Telecommunications Equipment",
  "currency": "USD",
  "price": 220.03,
  "change": 1.25,
  "changeAbsolute": 2.72,
  "volume": 48200000,
  "marketCap": 3280000000000,
  "priceEarningsRatio": 33.4,
  "earningsPerShareDiluted": 6.57,
  "relativeStrengthIndex14": 57.8,
  "recommendation": 0.35,
  "sourceUrl": "https://www.tradingview.com/markets/stocks-usa/market-movers-all-stocks/",
  "scrapedAt": "2026-08-05T20:00:00.000Z",
  "raw": { "Perf.W": 2.1, "Perf.1M": 4.8 }
}

Values vary with the live market. Fields unavailable for an instrument are returned as null.

Input settings

Field	Type	Description
markets	array	One or more of america, crypto, and forex.
maxItems	integer	Maximum total rows, from 1 to 10,000.
maxItemsPerMarket	integer	Optional cap for each selected market.
sortBy	string	Sort by market cap, volume, close, change, name, recommendation, or RSI.
sortOrder	string	asc or desc.
symbols	array	Optional exchange-qualified symbols.
filters	array	Numeric field, operation, and value filters.
customColumns	array	Additional supported TradingView columns preserved in raw.
proxyConfiguration	object	Optional Apify Proxy settings. Usually not required.

Supported extra columns include weekly/monthly/yearly performance, 52-week high and low, 10-day average volume, dividend yield, and one-year beta. Invalid fields are rejected before requests or charges.

Output fields

Field	Description
symbol, ticker, name, description	Instrument identifiers and names.
exchange, market, type, country	Trading venue and classification.
sector, industry, currency	Business and quote metadata.
price, change, changeAbsolute, volume	Current quote and activity values.
marketCap, priceEarningsRatio, earningsPerShareDiluted	Valuation and earnings values.
relativeStrengthIndex14, recommendation	Technical indicator values.
sourceUrl, scrapedAt	Public source and collection timestamp.
raw	Requested allowlisted scanner columns keyed by their original names.

Ready-to-run examples

Open a public example to inspect its input, run it, or reuse it as a task:

• Compare crypto and forex screener data
• Export US stocks by volume

Largest US stocks: select america, sort by market_cap_basic descending, and set your desired limit.

High-volume crypto: select crypto, sort by volume, and add a volume filter.

Multi-market snapshot: select all three markets and use maxItemsPerMarket to keep the dataset balanced.

Symbol watchlist: provide exchange-qualified values in symbols, such as NASDAQ:AAPL and NASDAQ:MSFT.

Pricing

This Actor uses pay-per-event pricing. See the live Apify Pricing tab for current rates and the estimated charge shown before each run.

API usage

cURL

curl -X POST "https://api.apify.com/v2/acts/fetch_cat~tradingview-screener-scraper/runs?token=$APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"markets":["america"],"maxItems":100}'

Node.js

import { ApifyClient } from 'apify-client';
const client = new ApifyClient({ token: process.env.APIFY_TOKEN });
const run = await client.actor('fetch_cat/tradingview-screener-scraper').call({ markets: ['america'], maxItems: 100 });
const { items } = await client.dataset(run.defaultDatasetId).listItems();

Python

from apify_client import ApifyClient
client = ApifyClient('YOUR_APIFY_TOKEN')
run = client.actor('fetch_cat/tradingview-screener-scraper').call(run_input={'markets': ['america'], 'maxItems': 100})
items = client.dataset(run['defaultDatasetId']).list_items().items

Use the dataset in JSON, CSV, Excel, or other supported formats. You can also schedule runs, connect webhooks, and integrate datasets with Google Sheets, Make, Zapier, or your own application.

MCP and AI agents

Connect through Apify MCP so an AI assistant can launch market scans and consume structured results.

$claude mcp add apify --transport http "https://mcp.apify.com/?tools=fetch_cat/tradingview-screener-scraper"

{"mcpServers":{"apify":{"type":"http","url":"https://mcp.apify.com/?tools=fetch_cat/tradingview-screener-scraper"}}}

Example prompts: “Export the 20 largest US stocks by market cap” or “Compare high-volume crypto and forex symbols.” Keep result limits small for interactive workflows.

Tips and limits

• TradingView values are live and may change between runs.
• Markets expose different metadata; for example, company sector fields are commonly unavailable for forex pairs.
• A symbol must be valid for its selected market to appear.
• Large limits take longer and may encounter upstream throttling. The Actor retries transient 429 and server errors.
• If one selected market fails, successfully collected rows from other markets are preserved and the run summary records the failure.
• This is an independent data extraction tool and is not affiliated with or endorsed by TradingView.
• Use exported data responsibly and follow TradingView's terms and applicable laws. This Actor does not provide financial advice.

FAQ

Does this Actor require a TradingView account?

No. It exports data available from TradingView's public market screeners.

Can I scrape a specific ticker?

Yes. Add exchange-qualified symbols such as NASDAQ:AAPL to symbols and select the matching market.

Can I use the results through an API or MCP?

Yes. Launch runs through the Apify API, consume the dataset in standard formats, or connect the Actor through Apify MCP.

Why are some fields null?

Not every market or instrument supplies company fundamentals, sector metadata, or every technical indicator. The Actor preserves a stable schema and uses null when the public source does not supply a value.

Is this a replacement for TradingView alerts or brokerage data?

No. It is designed for repeatable public screener exports and analysis workflows, not trade execution, guaranteed real-time feeds, or investment advice.

Related Actors

• Yahoo Finance Stock Data Scraper
• CoinMarketCap Crypto Prices Scraper
• Stocktwits Scraper
• SEC EDGAR Company Filings Scraper
• SEC Form 4 Insider Trades Scraper

Support

If a run fails or returns unexpected data, open an issue from the Actor's Apify Console page. Include the run URL and a redacted input example so the problem can be reproduced.