> ## 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 BetExplorer bookmaker odds for a match

> Reads one BetExplorer match and returns `event` (teams, `startTime`, `status`, `score`) and `markets` for the chosen `market`: each `selections` entry has the site's `average`, the `best` bookmaker price, and `odds` with every bookmaker's `decimal` price, `movement` (`up` or `down` where the site marks it) and `updatedAt`; betting exchanges carry `exchange: true` and are left out of `best`. Handicap and total markets return one entry per `line`. `availableMarkets` lists what else the match offers. A market with no bookmaker prices returns empty `markets` and a `message`.



## OpenAPI

````yaml /api-reference/openapi.json post /sports/betexplorer-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/betexplorer-odds:
    post:
      tags:
        - Plugins
      summary: Scrape BetExplorer bookmaker odds for a match
      description: >-
        Reads one BetExplorer match and returns `event` (teams, `startTime`,
        `status`, `score`) and `markets` for the chosen `market`: each
        `selections` entry has the site's `average`, the `best` bookmaker price,
        and `odds` with every bookmaker's `decimal` price, `movement` (`up` or
        `down` where the site marks it) and `updatedAt`; betting exchanges carry
        `exchange: true` and are left out of `best`. Handicap and total markets
        return one entry per `line`. `availableMarkets` lists what else the
        match offers. A market with no bookmaker prices returns empty `markets`
        and a `message`.
      operationId: betexplorer_odds_sports_betexplorer_odds_post
      parameters:
        - name: url
          in: query
          required: true
          schema:
            type: string
            description: >-
              A BetExplorer match page, as a link or path, e.g.
              'football/england/premier-league/arsenal-leeds/xtmHKGT0'.
            title: Url
          description: >-
            A BetExplorer match page, as a link or path, e.g.
            'football/england/premier-league/arsenal-leeds/xtmHKGT0'.
        - name: market
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: >-
              Market code: '1x2', 'ou' (over/under), 'ah' (Asian handicap), 'ha'
              (home/away), 'dc' (double chance), 'bts' (both teams to score).
              Defaults to the match's main market.
            title: Market
          description: >-
            Market code: '1x2', 'ou' (over/under), 'ah' (Asian handicap), 'ha'
            (home/away), 'dc' (double chance), 'bts' (both teams to score).
            Defaults to the match's main market.
        - 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 a match page, an unknown `market`, or an invalid proxy
            country.
        '404':
          description: BetExplorer has no page at this address.
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
        '502':
          description: Blocked, 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.