> ## 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 fixtures for a sport or competition

> Reads an Oddschecker sport or competition page and returns its `events`: name, teams, `startTime` (or the page's `date` and `time` where it shows no timestamp), `url`, and the headline `markets` with the best price per selection. Some sports also return every bookmaker's price in `odds`. Horse racing pages list races without prices; pass a race `url` to `/sports/oddschecker-odds` for those.



## OpenAPI

````yaml /api-reference/openapi.json post /sports/oddschecker-events
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-events:
    post:
      tags:
        - Plugins
      summary: Scrape Oddschecker fixtures for a sport or competition
      description: >-
        Reads an Oddschecker sport or competition page and returns its `events`:
        name, teams, `startTime` (or the page's `date` and `time` where it shows
        no timestamp), `url`, and the headline `markets` with the best price per
        selection. Some sports also return every bookmaker's price in `odds`.
        Horse racing pages list races without prices; pass a race `url` to
        `/sports/oddschecker-odds` for those.
      operationId: oddschecker_events_sports_oddschecker_events_post
      parameters:
        - name: url
          in: query
          required: true
          schema:
            type: string
            description: >-
              An Oddschecker sport or competition page, as a link or path, e.g.
              'football/english/premier-league' or 'basketball/nba'.
            title: Url
          description: >-
            An Oddschecker sport or competition page, as a link or path, e.g.
            'football/english/premier-league' or 'basketball/nba'.
        - 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 an `events` array.
          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 events 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.