# TradingView Screener & Technical Analysis Scraper (`parseforge/tradingview-screener-scraper`) Actor

Scrape TradingView's screener for technical ratings, indicators (RSI, MACD, ADX), price, volume and fundamentals across 73 markets. Built for quant analysts and algo traders feeding strategies.

- **URL**: https://apify.com/parseforge/tradingview-screener-scraper.md
- **Developed by:** [ParseForge](https://apify.com/parseforge) (community)
- **Categories:** Business, Developer tools
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks
- **User rating**: No ratings yet

## Pricing

from $22.50 / 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/platform/actors/running/actors-in-store#pay-per-event

## What's an Apify Actor?

Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases.
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.
Actors are written with capital "A".

## 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.
The best way to integrate Actors is as follows.

In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md):

```bash
npm install apify-client
```

In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md):

```bash
pip install apify-client
```

In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md):

````bash
# MacOS / Linux
curl -fsSL https://apify.com/install-cli.sh | bash
# Windows
irm https://apify.com/install-cli.ps1 | iex
```bash

In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md).

If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).


# README

![ParseForge Banner](https://github.com/ParseForge/apify-assets/blob/ad35ccc13ddd068b9d6cba33f323962e39aed5b2/banner.jpg?raw=true)

## 📈 TradingView Screener Scraper

> 🚀 **Export TradingView screener results in seconds.** Pull technical ratings, RSI, MACD and trading signals for thousands of symbols across 70+ markets. No API key, no registration, no manual CSV wrangling.

> 🕒 **Last updated:** 2026-05-30 · **📊 37 fields** per record · **70+ markets** · **19,000+ US stocks, 57,000+ crypto pairs** · **Stocks, crypto, forex, futures**

TradingView is where most retail and professional traders read the market, and its screener already computes a full technical-analysis verdict for every symbol it tracks. This Actor turns that screener into a clean, structured dataset. Pick a market, choose how to sort and filter, and get back the **overall technical rating** (Strong Buy to Strong Sell), the separate **moving-average** and **oscillator** ratings, and the raw indicators behind them: **RSI, MACD, Stochastic, ADX, CCI, momentum** and key **moving averages**. Each record also carries live price, daily change, volume and, for stocks, market cap, P/E and EPS.

Coverage is broad. The US market alone returns **19,000+ symbols**, crypto returns **57,000+ pairs**, and 60+ individual country stock markets are available, from Germany and India to Brazil and Japan. There is no login wall and no rate-limit dance: the Actor reads the same public screener data the TradingView website renders. Feed the output straight into a trading algorithm, a backtest, a watchlist, or a dashboard, and refresh it on a schedule to keep your signals current. Export to **CSV, Excel, JSON or XML** with one click.

| 🎯 Target Audience | 💡 Primary Use Cases |
|---|---|
| Quantitative analysts | Feed trading models with technical signals at scale |
| Retail and active traders | Build screens of Strong Buy / Strong Sell candidates |
| Algorithmic trading developers | Pull RSI, MACD and ratings into a backtest pipeline |
| Financial data providers | Source alternative technical-analysis datasets |

---

### 📋 What the TradingView Screener Scraper does

- 🎯 **Overall technical rating.** Returns TradingView's combined Strong Buy / Buy / Neutral / Sell / Strong Sell verdict for every symbol, plus the numeric score behind it.
- 📊 **Indicator-level detail.** Captures RSI, MACD and signal line, Stochastic %K/%D, ADX, CCI20, momentum and the 50/200 simple and 50 exponential moving averages.
- 🌍 **70+ markets.** Screen US stocks, crypto, forex, CFDs, futures and 60+ country stock exchanges from a single dropdown.
- 🧮 **Fundamentals on stocks.** Market cap, P/E ratio and EPS travel alongside the technicals for equity markets.
- 🔎 **Server-side filtering.** Narrow by sector or by technical rating so you only pull the candidates you care about.

Each record bundles identification (symbol, full exchange-qualified ticker, company or instrument name, logo and a direct TradingView link), live market data (price, percent and absolute change, day high and low, volume and 10-day average volume), the full technical-analysis block, and a timestamp. Stock markets add sector, industry and fundamentals; crypto and forex markets return the price and indicator fields that apply to them.

> 💡 **Why it matters:** the technical rating that traders eyeball one chart at a time becomes a sortable, filterable dataset of thousands of symbols, ready for code.

---

### 🎬 Full Demo

🚧 Coming soon: a 3-minute walkthrough of setting up a screen, filtering by rating, and exporting the results.

---

### ⚙️ Input

<table>
<tr><th>Field</th><th>Type</th><th>Description</th></tr>
<tr><td>market</td><td>select</td><td>Which TradingView market to screen. america, crypto, forex, cfd, futures, coin or any of 60+ country stock markets. Default america.</td></tr>
<tr><td>maxItems</td><td>integer</td><td>How many symbols to return. Free users are capped at 10. Default 10.</td></tr>
<tr><td>sortBy</td><td>select</td><td>Rank by Market Cap, Technical Rating, RSI, Change %, Volume or Price.</td></tr>
<tr><td>sortOrder</td><td>select</td><td>Descending (high to low) or ascending. Default descending.</td></tr>
<tr><td>sector</td><td>select</td><td>Optional sector filter for stock markets (for example Technology Services, Finance, Health Technology). Ignored on crypto and forex.</td></tr>
<tr><td>technicalRating</td><td>select</td><td>Optional filter: only return symbols rated Strong Buy, Buy, Neutral, Sell or Strong Sell.</td></tr>
</table>

Example: top 50 US stocks by market cap

```json
{
  "market": "america",
  "maxItems": 50,
  "sortBy": "market_cap_basic",
  "sortOrder": "desc"
}
````

Example: Strong Buy technology stocks, ranked by rating

```json
{
  "market": "america",
  "maxItems": 100,
  "sortBy": "Recommend.All",
  "sortOrder": "desc",
  "sector": "Technology Services",
  "technicalRating": "strong_buy"
}
```

> ⚠️ **Good to Know:** the `sector`, `marketCap`, `peRatio` and `eps` fields apply to stock markets only. On crypto, forex, CFD and futures they come back empty, and if you sort by a column that a market does not support, the Actor automatically falls back to sorting by price.

***

### 📊 Output

Every run returns one record per symbol. Stock markets populate the full schema; crypto and forex markets fill the price and indicator fields and leave equity-only fields empty.

#### 🧾 Schema

| Field | Type | Example |
|---|---|---|
| 🖼 `imageUrl` | string | `https://s3-symbol-logo.tradingview.com/nvidia--big.svg` |
| 🔤 `symbol` | string | `NVDA` |
| 🏷 `fullSymbol` | string | `NASDAQ:NVDA` |
| 📌 `name` | string | `NVIDIA Corporation` |
| 🔗 `url` | string | `https://www.tradingview.com/symbols/NASDAQ-NVDA/` |
| 🏛 `exchange` | string | `NASDAQ` |
| 📁 `type` | string | `stock` |
| 🏭 `sector` | string | `Electronic Technology` |
| 🔧 `industry` | string | `Semiconductors` |
| 💱 `currency` | string | `USD` |
| 💵 `price` | number | `211.14` |
| 📈 `changePercent` | number | `-1.45` |
| ➕ `changeAbs` | number | `-3.11` |
| 🔺 `high` | number | `217.86` |
| 🔻 `low` | number | `211.13` |
| 🔊 `volume` | number | `289399507` |
| 📦 `avgVolume10d` | number | `181325842` |
| 🏦 `marketCap` | number | `5109587985229` |
| ⚖️ `peRatio` | number | `32.33` |
| 💰 `eps` | number | `6.57` |
| 🎯 `technicalRating` | number | `0.07` |
| 🏅 `technicalRatingLabel` | string | `Neutral` |
| 📐 `maRating` | number | `0.13` |
| 🌀 `oscillatorsRating` | number | `0` |
| 📊 `rsi` | number | `49.41` |
| ⚡ `momentum` | number | `-24.6` |
| 📉 `macd` | number | `3.8087` |
| 〰️ `macdSignal` | number | `5.9741` |
| 🧭 `adx` | number | `22.59` |
| 🎚 `cci20` | number | `-19.31` |
| 🔵 `stochK` | number | `16.17` |
| 🟣 `stochD` | number | `26.91` |
| 📏 `sma50` | number | `199.35` |
| 📏 `sma200` | number | `187.65` |
| 📐 `ema50` | number | `204.66` |
| 🕒 `scrapedAt` | string | `2026-05-30T13:13:02.568Z` |
| ❌ `error` | string | null | `null` |

#### 📦 Sample records

<details>
<summary>Typical record (US large-cap stock)</summary>

```json
{
  "imageUrl": "https://s3-symbol-logo.tradingview.com/nvidia--big.svg",
  "symbol": "NVDA",
  "fullSymbol": "NASDAQ:NVDA",
  "name": "NVIDIA Corporation",
  "url": "https://www.tradingview.com/symbols/NASDAQ-NVDA/",
  "exchange": "NASDAQ",
  "type": "stock",
  "sector": "Electronic Technology",
  "industry": "Semiconductors",
  "currency": "USD",
  "price": 211.14,
  "changePercent": -1.45,
  "changeAbs": -3.11,
  "high": 217.8599,
  "low": 211.13,
  "volume": 289399507,
  "avgVolume10d": 181325842,
  "marketCap": 5109587985229.001,
  "peRatio": 32.33,
  "eps": 6.57,
  "technicalRating": 0.07,
  "technicalRatingLabel": "Neutral",
  "maRating": 0.13,
  "oscillatorsRating": 0,
  "rsi": 49.41,
  "momentum": -24.6,
  "macd": 3.8087,
  "macdSignal": 5.9741,
  "adx": 22.59,
  "cci20": -19.31,
  "stochK": 16.17,
  "stochD": 26.91,
  "sma50": 199.3488,
  "sma200": 187.6532,
  "ema50": 204.6627,
  "scrapedAt": "2026-05-30T13:13:02.568Z",
  "error": null
}
```

</details>

<details>
<summary>Edge case (overbought, Buy rating)</summary>

```json
{
  "imageUrl": "https://s3-symbol-logo.tradingview.com/apple--big.svg",
  "symbol": "AAPL",
  "fullSymbol": "NASDAQ:AAPL",
  "name": "Apple Inc.",
  "url": "https://www.tradingview.com/symbols/NASDAQ-AAPL/",
  "exchange": "NASDAQ",
  "type": "stock",
  "sector": "Electronic Technology",
  "industry": "Telecommunications Equipment",
  "currency": "USD",
  "price": 312.06,
  "changePercent": -0.14,
  "changeAbs": -0.45,
  "high": 315,
  "low": 309.53,
  "volume": 70026560,
  "avgVolume10d": 47313217,
  "marketCap": 4583336416465.999,
  "peRatio": 37.75,
  "eps": 8.3,
  "technicalRating": 0.35,
  "technicalRatingLabel": "Buy",
  "maRating": 0.8,
  "oscillatorsRating": -0.09,
  "rsi": 78.79,
  "momentum": 13.85,
  "macd": 10.3912,
  "macdSignal": 9.7768,
  "adx": 43.81,
  "cci20": 120.25,
  "stochK": 92.05,
  "stochD": 91.7,
  "sma50": 275.2856,
  "sma200": 263.2374,
  "ema50": 283.2341,
  "scrapedAt": "2026-05-30T13:13:02.568Z",
  "error": null
}
```

</details>

<details>
<summary>Sparse record (crypto pair, equity fields empty)</summary>

```json
{
  "imageUrl": null,
  "symbol": "TWTUSDT",
  "fullSymbol": "BITUNIX:TWTUSDT",
  "name": "Trust Wallet Token / Tether SPOT",
  "url": "https://www.tradingview.com/symbols/BITUNIX-TWTUSDT/",
  "exchange": "BITUNIX",
  "type": "spot",
  "sector": null,
  "industry": null,
  "currency": "USDT",
  "price": 0.4506,
  "changePercent": 0.94,
  "changeAbs": 0.0042,
  "high": 0.4544,
  "low": 0.4462,
  "volume": 167248,
  "avgVolume10d": 287455,
  "marketCap": null,
  "peRatio": null,
  "eps": null,
  "technicalRating": -0.29,
  "technicalRatingLabel": "Sell",
  "maRating": -0.67,
  "oscillatorsRating": 0.09,
  "rsi": 46.28,
  "momentum": -0.014,
  "macd": -0.0031,
  "macdSignal": 0.0014,
  "adx": 22.57,
  "cci20": -63.83,
  "stochK": 23.09,
  "stochD": 18.1,
  "sma50": 0.4465,
  "sma200": 0.6683,
  "ema50": 0.4596,
  "scrapedAt": "2026-05-30T13:21:34.270Z",
  "error": null
}
```

</details>

***

### ✨ Why choose this Actor

| | Capability |
|---|---|
| 🎯 | **Decision-ready ratings.** Strong Buy to Strong Sell labels plus the numeric score, not just raw numbers to interpret yourself. |
| 📊 | **Full indicator block.** RSI, MACD, Stochastic, ADX, CCI, momentum and moving averages on every record. |
| 🌍 | **70+ markets.** One Actor covers US equities, crypto, forex, futures and 60+ country exchanges. |
| 🧮 | **Fundamentals included.** Market cap, P/E and EPS ship alongside the technicals for stocks. |
| 🔎 | **Filter before you pull.** Sector and rating filters run server-side, so you only pay for the rows you want. |
| ⚡ | **No login, no key.** Reads public screener data; nothing to configure or authenticate. |
| 📁 | **Any format.** Export to CSV, Excel, JSON or XML, or pull straight from the dataset API. |

> 📊 The US market alone exposes more than 19,000 screenable symbols, each with a computed technical rating.

***

### 📈 How it compares to alternatives

| Approach | Cost | Coverage | Refresh | Filters | Setup |
|---|---|---|---|---|---|
| **⭐ TradingView Screener Scraper** *(this Actor)* | Low | 70+ markets, 19k+ US symbols | On demand | Sector + rating | Minutes |
| Manual screener export | Free | One screen at a time | Manual | Limited | Tedious |
| Paid live market APIs | High | Broad | Real time | Varies | Keys + quotas |
| Indicator libraries you self-host | Engineering time | Your data only | You build it | You build it | High |

This Actor gives you the computed technical verdict and the indicators behind it, exportable in minutes and refreshable on a schedule.

***

### 🚀 How to use

1. 🔐 **Sign up.** Create a free Apify account at [console.apify.com/sign-up](https://console.apify.com/sign-up?fpr=vmoqkp). It takes under a minute.
2. 🎛 **Pick a market.** Choose `america`, `crypto`, `forex` or any of the 70+ markets from the dropdown.
3. 🔧 **Set sorting and filters.** Rank by rating, RSI or market cap, and optionally filter by sector or technical rating.
4. ▶️ **Run the Actor.** Click Start and watch the screener results stream into the dataset.
5. 📥 **Export.** Download as CSV, Excel, JSON or XML, or pull from the dataset API into your pipeline.

> ⏱️ Total time: about two minutes from sign-up to your first exported screen.

***

### 💼 Business use cases

<table>
<tr>
<td width="50%">

#### 📐 Quantitative analysts

- Pull technical ratings for a full market in one run
- Build factor screens from RSI, MACD and ADX
- Snapshot signals on a schedule for backtests
- Compare ratings across sectors and regions

</td>
<td width="50%">

#### 💹 Active traders

- Generate Strong Buy / Strong Sell watchlists daily
- Spot overbought and oversold names by RSI
- Filter a sector down to its best-rated symbols
- Track moving-average alignment across a market

</td>
</tr>
<tr>
<td width="50%">

#### 🤖 Algo developers

- Feed structured signals into a trading model
- Seed a backtest with thousands of symbols at once
- Automate a daily screen via the Apify API
- Combine technicals with the included fundamentals

</td>
<td width="50%">

#### 🗂 Data providers

- Source an alternative technical-analysis dataset
- Resell normalized signals across 70+ markets
- Enrich existing market feeds with rating fields
- Maintain a refreshed history of screener snapshots

</td>
</tr>
</table>

***

### 🌟 Beyond business use cases

Data like this powers more than commercial workflows. The same structured records support research, education, civic projects, and personal initiatives.

<table>
<tr>
<td width="50%">

#### 🎓 Research and academia

- Empirical datasets for papers, thesis work, and coursework
- Longitudinal studies tracking changes across snapshots
- Reproducible research with cited, versioned data pulls
- Classroom exercises on data analysis and ethical scraping

</td>
<td width="50%">

#### 🎨 Personal and creative

- Side projects, portfolio demos, and indie app launches
- Data visualizations, dashboards, and infographics
- Content research for bloggers, YouTubers, and podcasters
- Hobbyist collections and personal trackers

</td>
</tr>
<tr>
<td width="50%">

#### 🤝 Non-profit and civic

- Transparency reporting and accountability projects
- Advocacy campaigns backed by public-interest data
- Community-run databases for local issues
- Investigative journalism on public records

</td>
<td width="50%">

#### 🧪 Experimentation

- Prototype AI and machine-learning pipelines with real data
- Validate product-market hypotheses before engineering spend
- Train small domain-specific models on niche corpora
- Test dashboard concepts with live input

</td>
</tr>
</table>

***

### 🔌 Automating TradingView Screener Scraper

Run this Actor by hand or wire it into your stack programmatically.

- **Node.js:** use the [apify-client](https://docs.apify.com/api/client/js/) package to start runs and read datasets.
- **Python:** use the [apify-client](https://docs.apify.com/api/client/python/) library to integrate with pandas or your trading code.
- **API docs:** see the [Apify API reference](https://docs.apify.com/api/v2) for endpoints and authentication.

Use Apify [Schedules](https://docs.apify.com/platform/schedules) to refresh your screens automatically, for example a daily pre-market pull of the latest technical ratings.

***

### ❓ Frequently Asked Questions

<details>
<summary>📊 What data does this Actor return?</summary>

For each symbol it returns the overall technical rating (Strong Buy to Strong Sell), separate moving-average and oscillator ratings, the indicators behind them (RSI, MACD, Stochastic, ADX, CCI, momentum, moving averages), live price and change, volume, and for stocks market cap, P/E and EPS.

</details>

<details>
<summary>🌍 Which markets are supported?</summary>

US stocks, crypto, forex, CFDs, futures, crypto coins, and 60+ individual country stock markets including the UK, Germany, India, Japan, Brazil and more. Pick one from the market dropdown.

</details>

<details>
<summary>🔢 How many symbols can I get?</summary>

Paid users can pull up to 1,000,000 items per run. The US market alone exposes more than 19,000 symbols and crypto more than 57,000 pairs. Free users get a 10-item preview.

</details>

<details>
<summary>🎯 How is the technical rating calculated?</summary>

The rating comes directly from TradingView's screener, which aggregates a set of moving averages and oscillators into a single score from -1 to 1. The Actor maps that score to a Strong Buy / Buy / Neutral / Sell / Strong Sell label and also returns the raw number.

</details>

<details>
<summary>🧮 Why are some fields empty on crypto and forex?</summary>

Sector, industry, market cap, P/E and EPS are equity concepts. TradingView does not publish them for crypto, forex, CFD or futures markets, so those fields come back empty for non-stock symbols.

</details>

<details>
<summary>🔎 Can I filter the results?</summary>

Yes. Filter stock markets by sector, and any market by technical rating (for example only Strong Buy symbols). Both filters run server-side so you only receive matching rows.

</details>

<details>
<summary>⏱ How fresh is the data?</summary>

Each run reads the live screener at request time, so the values match what the TradingView website shows then. Schedule the Actor to keep a refreshed dataset.

</details>

<details>
<summary>📁 What export formats are available?</summary>

CSV, Excel, JSON, XML and an HTML table, plus direct access through the Apify dataset API.

</details>

<details>
<summary>🔑 Do I need a TradingView account or API key?</summary>

No. The Actor reads public screener data and requires no login, account or API key on the source side.

</details>

<details>
<summary>💼 Can I use this commercially?</summary>

Yes. The Actor collects publicly available market data that you can use within your own analysis, products and workflows. You are responsible for complying with applicable terms and laws in your jurisdiction.

</details>

<details>
<summary>💳 Is there a paid plan?</summary>

The Actor runs on your Apify account. A free account lets you preview results; a paid plan raises limits to up to 1,000,000 items per run. Pricing for the Actor itself is shown on its Apify page.

</details>

<details>
<summary>🛠 What if a run fails or returns no data?</summary>

Check that your market and filters can return results (for example a very narrow sector plus rating combination may match nothing). If a request to the source fails, the Actor records an `error` field instead of crashing. Re-running usually resolves transient issues, and you can always reach us through the contact form below.

</details>

***

### 🔌 Integrate with any app

Connect the dataset to the tools you already use:

- [**Make**](https://www.make.com/en/integrations/apify) - build no-code automations around each run.
- [**Zapier**](https://zapier.com/apps/apify/integrations) - push results into thousands of apps.
- [**Slack**](https://apify.com/integrations) - post new screener results to a channel.
- [**Google Sheets**](https://apify.com/integrations) - sync rows into a live spreadsheet.
- [**Airbyte**](https://apify.com/integrations) - load data into your warehouse.
- [**GitHub**](https://apify.com/integrations) - trigger runs from your CI pipeline.

***

### 🔗 Recommended Actors

- [**📈 TradingView Ideas Scraper**](https://apify.com/parseforge/tradingview-ideas-scraper) - community trading ideas with bias, targets and chart images.
- [**📊 Finviz Stock Screener**](https://apify.com/parseforge) - screen US equities by fundamentals and technicals.
- [**💹 Yahoo Finance Scraper**](https://apify.com/parseforge) - quotes, fundamentals and historical prices.
- [**🏦 SEC EDGAR Scraper**](https://apify.com/parseforge) - company filings and financial disclosures.
- [**🪙 Crypto Market Scraper**](https://apify.com/parseforge) - prices and market data across exchanges.

> 💡 **Pro Tip:** browse the complete [ParseForge collection](https://apify.com/parseforge) for more market and finance data Actors.

***

**🆘 Need Help?** [**Open our contact form**](https://tally.so/r/BzdKgA)

***

> **⚠️ Disclaimer:** this is an independent tool and is not affiliated with, endorsed by, or sponsored by TradingView. It collects only publicly available data. You are responsible for using the data in compliance with applicable terms and laws.

# Actor input Schema

## `market` (type: `string`):

Which TradingView market to screen. Stock markets expose sector, market cap and fundamentals; crypto/forex/cfd return price and technical indicators only.

## `maxItems` (type: `integer`):

Free users: Limited to 10 items (preview). Paid users: Optional, max 1,000,000

## `sortBy` (type: `string`):

Column used to rank the screener results.

## `sortOrder` (type: `string`):

Ascending or descending order.

## `sector` (type: `string`):

Filter stock markets by sector. Ignored for crypto, forex, cfd, futures and bonds.

## `technicalRating` (type: `string`):

Only return symbols whose overall TradingView technical rating matches.

## Actor input object example

```json
{
  "market": "america",
  "maxItems": 10,
  "sortBy": "market_cap_basic",
  "sortOrder": "desc",
  "technicalRating": ""
}
```

# 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 = {
    "maxItems": 10
};

// Run the Actor and wait for it to finish
const run = await client.actor("parseforge/tradingview-screener-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 = { "maxItems": 10 }

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

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

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

```

## CLI example

```bash
echo '{
  "maxItems": 10
}' |
apify call parseforge/tradingview-screener-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=parseforge/tradingview-screener-scraper",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "TradingView Screener & Technical Analysis Scraper",
        "description": "Scrape TradingView's screener for technical ratings, indicators (RSI, MACD, ADX), price, volume and fundamentals across 73 markets. Built for quant analysts and algo traders feeding strategies.",
        "version": "0.1",
        "x-build-id": "ryjKCOuRodGW5dizU"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/parseforge~tradingview-screener-scraper/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-parseforge-tradingview-screener-scraper",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        },
        "/acts/parseforge~tradingview-screener-scraper/runs": {
            "post": {
                "operationId": "runs-sync-parseforge-tradingview-screener-scraper",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor and returns information about the initiated run in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/runsResponseSchema"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/acts/parseforge~tradingview-screener-scraper/run-sync": {
            "post": {
                "operationId": "run-sync-parseforge-tradingview-screener-scraper",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        }
    },
    "components": {
        "schemas": {
            "inputSchema": {
                "type": "object",
                "properties": {
                    "market": {
                        "title": "Market",
                        "enum": [
                            "america",
                            "crypto",
                            "forex",
                            "cfd",
                            "futures",
                            "coin",
                            "argentina",
                            "australia",
                            "austria",
                            "bahrain",
                            "bangladesh",
                            "belgium",
                            "brazil",
                            "canada",
                            "chile",
                            "china",
                            "colombia",
                            "cyprus",
                            "czech",
                            "denmark",
                            "egypt",
                            "estonia",
                            "finland",
                            "france",
                            "germany",
                            "greece",
                            "hongkong",
                            "hungary",
                            "iceland",
                            "india",
                            "indonesia",
                            "israel",
                            "italy",
                            "japan",
                            "kenya",
                            "korea",
                            "ksa",
                            "kuwait",
                            "latvia",
                            "lithuania",
                            "luxembourg",
                            "malaysia",
                            "mexico",
                            "morocco",
                            "netherlands",
                            "newzealand",
                            "nigeria",
                            "norway",
                            "pakistan",
                            "peru",
                            "philippines",
                            "poland",
                            "portugal",
                            "qatar",
                            "romania",
                            "rsa",
                            "russia",
                            "serbia",
                            "singapore",
                            "slovakia",
                            "slovenia",
                            "spain",
                            "srilanka",
                            "sweden",
                            "switzerland",
                            "taiwan",
                            "thailand",
                            "tunisia",
                            "turkey",
                            "uae",
                            "uk",
                            "venezuela",
                            "vietnam"
                        ],
                        "type": "string",
                        "description": "Which TradingView market to screen. Stock markets expose sector, market cap and fundamentals; crypto/forex/cfd return price and technical indicators only.",
                        "default": "america"
                    },
                    "maxItems": {
                        "title": "Max Items",
                        "minimum": 1,
                        "maximum": 1000000,
                        "type": "integer",
                        "description": "Free users: Limited to 10 items (preview). Paid users: Optional, max 1,000,000"
                    },
                    "sortBy": {
                        "title": "Sort By",
                        "enum": [
                            "market_cap_basic",
                            "Recommend.All",
                            "RSI",
                            "change",
                            "volume",
                            "close"
                        ],
                        "type": "string",
                        "description": "Column used to rank the screener results.",
                        "default": "market_cap_basic"
                    },
                    "sortOrder": {
                        "title": "Sort Order",
                        "enum": [
                            "desc",
                            "asc"
                        ],
                        "type": "string",
                        "description": "Ascending or descending order.",
                        "default": "desc"
                    },
                    "sector": {
                        "title": "Sector",
                        "enum": [
                            "",
                            "Commercial Services",
                            "Communications",
                            "Consumer Durables",
                            "Consumer Non-Durables",
                            "Consumer Services",
                            "Distribution Services",
                            "Electronic Technology",
                            "Energy Minerals",
                            "Finance",
                            "Government",
                            "Health Services",
                            "Health Technology",
                            "Industrial Services",
                            "Miscellaneous",
                            "Non-Energy Minerals",
                            "Process Industries",
                            "Producer Manufacturing",
                            "Retail Trade",
                            "Technology Services",
                            "Transportation",
                            "Utilities"
                        ],
                        "type": "string",
                        "description": "Filter stock markets by sector. Ignored for crypto, forex, cfd, futures and bonds."
                    },
                    "technicalRating": {
                        "title": "Technical Rating",
                        "enum": [
                            "",
                            "strong_buy",
                            "buy",
                            "neutral",
                            "sell",
                            "strong_sell"
                        ],
                        "type": "string",
                        "description": "Only return symbols whose overall TradingView technical rating matches.",
                        "default": ""
                    }
                }
            },
            "runsResponseSchema": {
                "type": "object",
                "properties": {
                    "data": {
                        "type": "object",
                        "properties": {
                            "id": {
                                "type": "string"
                            },
                            "actId": {
                                "type": "string"
                            },
                            "userId": {
                                "type": "string"
                            },
                            "startedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "finishedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "status": {
                                "type": "string",
                                "example": "READY"
                            },
                            "meta": {
                                "type": "object",
                                "properties": {
                                    "origin": {
                                        "type": "string",
                                        "example": "API"
                                    },
                                    "userAgent": {
                                        "type": "string"
                                    }
                                }
                            },
                            "stats": {
                                "type": "object",
                                "properties": {
                                    "inputBodyLen": {
                                        "type": "integer",
                                        "example": 2000
                                    },
                                    "rebootCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "restartCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "resurrectCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "computeUnits": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "options": {
                                "type": "object",
                                "properties": {
                                    "build": {
                                        "type": "string",
                                        "example": "latest"
                                    },
                                    "timeoutSecs": {
                                        "type": "integer",
                                        "example": 300
                                    },
                                    "memoryMbytes": {
                                        "type": "integer",
                                        "example": 1024
                                    },
                                    "diskMbytes": {
                                        "type": "integer",
                                        "example": 2048
                                    }
                                }
                            },
                            "buildId": {
                                "type": "string"
                            },
                            "defaultKeyValueStoreId": {
                                "type": "string"
                            },
                            "defaultDatasetId": {
                                "type": "string"
                            },
                            "defaultRequestQueueId": {
                                "type": "string"
                            },
                            "buildNumber": {
                                "type": "string",
                                "example": "1.0.0"
                            },
                            "containerUrl": {
                                "type": "string"
                            },
                            "usage": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "integer",
                                        "example": 1
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "usageTotalUsd": {
                                "type": "number",
                                "example": 0.00005
                            },
                            "usageUsd": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "number",
                                        "example": 0.00005
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
