> ## 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 Oddschecker betting odds for an event

> Reads one Oddschecker event page and returns `event` (name, competition, teams, `startTime`), `markets` with their `selections`, and for each selection every price in `odds` (`decimal`, `fractional`, each-way terms where offered; betting exchanges carry `exchange: true`) plus `best`: the top bookmaker price and who offers it, leaving exchanges out as Oddschecker does. `availableMarkets` names the other markets of the event. Works for match pages, outright winners and horse races. A runner priced only at starting price has no `odds`, and one priced only on exchanges has no `best`. An event Oddschecker lists without prices yet returns empty `markets` and a `message`.



## OpenAPI

````yaml /api-reference/openapi.json post /sports/oddschecker-odds
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:
  /sports/oddschecker-odds:
    post:
      tags:
        - Plugins
      summary: Scrape Oddschecker betting odds for an event
      description: >-
        Reads one Oddschecker event page and returns `event` (name, competition,
        teams, `startTime`), `markets` with their `selections`, and for each
        selection every price in `odds` (`decimal`, `fractional`, each-way terms
        where offered; betting exchanges carry `exchange: true`) plus `best`:
        the top bookmaker price and who offers it, leaving exchanges out as
        Oddschecker does. `availableMarkets` names the other markets of the
        event. Works for match pages, outright winners and horse races. A runner
        priced only at starting price has no `odds`, and one priced only on
        exchanges has no `best`. An event Oddschecker lists without prices yet
        returns empty `markets` and a `message`.
      operationId: oddschecker_odds_sports_oddschecker_odds_post
      parameters:
        - name: url
          in: query
          required: true
          schema:
            type: string
            description: >-
              An Oddschecker event page, as a link or path, e.g.
              'football/english/premier-league/man-city-v-fulham/winner'.
            title: Url
          description: >-
            An Oddschecker event page, as a link or path, e.g.
            'football/english/premier-league/man-city-v-fulham/winner'.
        - 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. 'GB', 'DE').
              Leave blank to let the API pick.
            title: Proxy Country
          description: >-
            Proxy country the request is sent from (ISO-2, e.g. 'GB', 'DE').
            Leave blank to let the API pick.
      responses:
        '200':
          description: JSON with `event` and `markets`.
          content:
            application/json:
              schema: {}
        '400':
          description: '`url` is not an Oddschecker page, or the proxy country is invalid.'
        '404':
          description: Oddschecker has no page at this address.
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
        '502':
          description: Blocked, no odds on that 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.