> ## Documentation Index
> Fetch the complete documentation index at: https://docs.scrapeunblocker.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Scrape a TradingView market-movers list

> Returns `rows` from a public TradingView market-movers page for a stock market: `symbol`, `ticker`, `name`, `exchange`, `price`, `currency`, `changePercent`, `volume`, `relativeVolume`, `marketCap`, `peRatio`, `eps`, `dividendYield`, `sector`, `analystRating` and `url`, plus whatever extra columns that list shows (for example `rsi` on the overbought list). `totalCount` is how many stocks match the list on TradingView; the page itself shows the top rows of it, at most 100. `sort` re-orders those rows, it does not fetch a different top of the list. Session lists such as after-hours movers can be empty outside their session; those return empty `rows` and a `message`.



## OpenAPI

````yaml /api-reference/openapi.json post /finance/tradingview-screener
openapi: 3.1.0
info:
  title: ScrapeUnblocker API
  description: >-
    Public API for the ScrapeUnblocker proxy/anti-bot service. Authenticate
    every request with the `x-scrapeunblocker-key` header. Documented here:
    page-source extraction, Google SERP scraping, image fetch, and the dedicated
    plugin endpoints (search engines, marketplaces, reviews, travel, social and
    more). All other paths exist for internal operations and are intentionally
    hidden from this spec.
  version: 3.0.0
servers:
  - url: https://api.scrapeunblocker.com
    description: Production
security: []
paths:
  /finance/tradingview-screener:
    post:
      tags:
        - Plugins
      summary: Scrape a TradingView market-movers list
      description: >-
        Returns `rows` from a public TradingView market-movers page for a stock
        market: `symbol`, `ticker`, `name`, `exchange`, `price`, `currency`,
        `changePercent`, `volume`, `relativeVolume`, `marketCap`, `peRatio`,
        `eps`, `dividendYield`, `sector`, `analystRating` and `url`, plus
        whatever extra columns that list shows (for example `rsi` on the
        overbought list). `totalCount` is how many stocks match the list on
        TradingView; the page itself shows the top rows of it, at most 100.
        `sort` re-orders those rows, it does not fetch a different top of the
        list. Session lists such as after-hours movers can be empty outside
        their session; those return empty `rows` and a `message`.
      operationId: tradingview_screener_finance_tradingview_screener_post
      parameters:
        - name: market
          in: query
          required: false
          schema:
            type: string
            description: >-
              Stock market as it appears in TradingView addresses, e.g. 'usa',
              'germany', 'japan', 'india', 'united-kingdom'.
            default: usa
            title: Market
          description: >-
            Stock market as it appears in TradingView addresses, e.g. 'usa',
            'germany', 'japan', 'india', 'united-kingdom'.
        - name: list
          in: query
          required: false
          schema:
            type: string
            description: >-
              Which list, e.g. 'gainers', 'losers', 'active', 'large-cap',
              'small-cap', 'unusual-volume', 'most-volatile', 'overbought',
              'oversold', 'best-performing', 'high-dividend', 'ath', 'atl',
              '52wk-high', '52wk-low', 'pre-market-gainers',
              'after-hours-gainers', 'all-stocks'.
            default: gainers
            title: List
          description: >-
            Which list, e.g. 'gainers', 'losers', 'active', 'large-cap',
            'small-cap', 'unusual-volume', 'most-volatile', 'overbought',
            'oversold', 'best-performing', 'high-dividend', 'ath', 'atl',
            '52wk-high', '52wk-low', 'pre-market-gainers',
            'after-hours-gainers', 'all-stocks'.
        - name: sort
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: >-
              Row field to re-order by, e.g. 'marketCap', 'volume',
              'changePercent', 'peRatio'. Leave blank for the site's order.
            title: Sort
          description: >-
            Row field to re-order by, e.g. 'marketCap', 'volume',
            'changePercent', 'peRatio'. Leave blank for the site's order.
        - name: order
          in: query
          required: false
          schema:
            type: string
            description: '''desc'' (highest first) or ''asc''. Used with `sort`.'
            default: desc
            title: Order
          description: '''desc'' (highest first) or ''asc''. Used with `sort`.'
        - name: limit
          in: query
          required: false
          schema:
            type: integer
            description: Rows to return, 1 to 100.
            default: 100
            title: Limit
          description: Rows to return, 1 to 100.
        - name: proxy_country
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: >-
              Proxy country the request is sent from (ISO-2, e.g. 'US', 'DE').
              Leave blank to let the API pick.
            title: Proxy Country
          description: >-
            Proxy country the request is sent from (ISO-2, e.g. 'US', 'DE').
            Leave blank to let the API pick.
      responses:
        '200':
          description: JSON with `rows`, `totalCount`, `market` and `list`.
          content:
            application/json:
              schema: {}
        '400':
          description: >-
            `market`, `list`, `sort`, `order` or `limit` is invalid, or the
            proxy country is.
        '404':
          description: TradingView has no such market or list.
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
        '502':
          description: Blocked, no rows on the page, or the call did not finish in time.
      security:
        - ScrapeUnblockerKey: []
components:
  schemas:
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError
  securitySchemes:
    ScrapeUnblockerKey:
      type: apiKey
      in: header
      name: x-scrapeunblocker-key
      description: Your ScrapeUnblocker API key. Apply on every request.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.