> ## 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 MarketWatch stock quote

> Reads a stock's MarketWatch quote page and returns `price`, `change`, `changePercent`, `previousClose`, `marketState` and `quoteTime`; `keyData` (open, day and 52-week ranges, market cap, shares, beta, P/E, EPS, dividend and short interest); `performance` over 5 days to 1 year; `analyst` (consensus, target price, yearly and quarterly EPS estimates, rating history and recent rating changes); `competitors`; and news `headlines` with links, sources and times. Pass `country_code` for a listing outside the US; those listings return only the consensus and number of ratings in `analyst`. Figures are numbers in the listing's own units, and some non-US listings mix units (a London price is in pence, its market cap in pounds). `unavailable` lists any section that could not be read.



## OpenAPI

````yaml /api-reference/openapi.json post /finance/marketwatch-quote
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/marketwatch-quote:
    post:
      tags:
        - Plugins
      summary: Scrape a MarketWatch stock quote
      description: >-
        Reads a stock's MarketWatch quote page and returns `price`, `change`,
        `changePercent`, `previousClose`, `marketState` and `quoteTime`;
        `keyData` (open, day and 52-week ranges, market cap, shares, beta, P/E,
        EPS, dividend and short interest); `performance` over 5 days to 1 year;
        `analyst` (consensus, target price, yearly and quarterly EPS estimates,
        rating history and recent rating changes); `competitors`; and news
        `headlines` with links, sources and times. Pass `country_code` for a
        listing outside the US; those listings return only the consensus and
        number of ratings in `analyst`. Figures are numbers in the listing's own
        units, and some non-US listings mix units (a London price is in pence,
        its market cap in pounds). `unavailable` lists any section that could
        not be read.
      operationId: marketwatch_quote_finance_marketwatch_quote_post
      parameters:
        - name: symbol
          in: query
          required: true
          schema:
            type: string
            description: Ticker symbol, e.g. 'AAPL'.
            title: Symbol
          description: Ticker symbol, e.g. 'AAPL'.
        - name: country_code
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: >-
              MarketWatch country code of the listing for stocks outside the US,
              e.g. 'uk' (London), 'xe' (Xetra) or 'jp' (Tokyo). Leave blank for
              US stocks.
            title: Country Code
          description: >-
            MarketWatch country code of the listing for stocks outside the US,
            e.g. 'uk' (London), 'xe' (Xetra) or 'jp' (Tokyo). Leave blank for US
            stocks.
        - 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 `price`, `keyData`, `analyst` and `headlines`.
          content:
            application/json:
              schema: {}
        '400':
          description: >-
            `symbol` or `country_code` is malformed, or the proxy country is
            invalid.
        '404':
          description: MarketWatch has no stock with this symbol.
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
        '502':
          description: >-
            Blocked, no usable data 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.