> ## 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.

# Pinnacle sports betting odds for a sport or league

> Reads Pinnacle's public odds board and returns `matchups`: id, `league`, `home`, `away`, `startTime`, `live`, `url`, and `markets`, each with `type` (`moneyline`, `spread`, `total`, `team_total`), `period` and `periodName`, `alternate`, `maxRiskStake`, `margin` and `selections` (`name`, `side`, `points`, `american`, `decimal`, `impliedProbability`, `fairProbability`). Prices are numbers, in American and decimal form. `sport` is a name such as `basketball`, `soccer`, `hockey`, `tennis`, or an id; `football` means American football (use `soccer` for association football). Passing a `league` returns every period, alternate lines and, with `include_specials=true`, player props and futures in `specials`; a whole-sport call returns each game's main lines (`marketCoverage: main`). A league with nothing on offer returns empty `matchups` and a `message`. Geo-dependent: pass `proxy_country` to choose where the request is sent from.



## OpenAPI

````yaml /api-reference/openapi.json post /sports/pinnacle-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/pinnacle-odds:
    post:
      tags:
        - Plugins
      summary: Pinnacle sports betting odds for a sport or league
      description: >-
        Reads Pinnacle's public odds board and returns `matchups`: id, `league`,
        `home`, `away`, `startTime`, `live`, `url`, and `markets`, each with
        `type` (`moneyline`, `spread`, `total`, `team_total`), `period` and
        `periodName`, `alternate`, `maxRiskStake`, `margin` and `selections`
        (`name`, `side`, `points`, `american`, `decimal`, `impliedProbability`,
        `fairProbability`). Prices are numbers, in American and decimal form.
        `sport` is a name such as `basketball`, `soccer`, `hockey`, `tennis`, or
        an id; `football` means American football (use `soccer` for association
        football). Passing a `league` returns every period, alternate lines and,
        with `include_specials=true`, player props and futures in `specials`; a
        whole-sport call returns each game's main lines (`marketCoverage:
        main`). A league with nothing on offer returns empty `matchups` and a
        `message`. Geo-dependent: pass `proxy_country` to choose where the
        request is sent from.
      operationId: pinnacle_odds_sports_pinnacle_odds_post
      parameters:
        - name: sport
          in: query
          required: true
          schema:
            type: string
            description: >-
              Sport name or id, e.g. 'basketball', 'soccer', 'hockey', 'tennis',
              '4'. A well-known league also works here, e.g. 'nba' or 'epl'.
            title: Sport
          description: >-
            Sport name or id, e.g. 'basketball', 'soccer', 'hockey', 'tennis',
            '4'. A well-known league also works here, e.g. 'nba' or 'epl'.
        - name: league
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: League name or id, e.g. 'nba', 'epl', 'Spain - La Liga', or '487'.
            title: League
          description: League name or id, e.g. 'nba', 'epl', 'Spain - La Liga', or '487'.
        - name: include_specials
          in: query
          required: false
          schema:
            type: boolean
            description: Add player props and futures in `specials` (only with a league).
            default: false
            title: Include Specials
          description: Add player props and futures in `specials` (only with a league).
        - 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', 'GB').
              Leave blank to let the API pick.
            title: Proxy Country
          description: >-
            Proxy country the request is sent from (ISO-2, e.g. 'US', 'GB').
            Leave blank to let the API pick.
      responses:
        '200':
          description: >-
            JSON with `sport` and `matchups` (empty with a `message` when
            nothing is on offer).
          content:
            application/json:
              schema: {}
        '400':
          description: >-
            `sport` or `league` is not usable, more than one league matches, or
            the proxy country is invalid.
        '404':
          description: Pinnacle has no such sport or league.
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
        '502':
          description: Blocked, unreadable, 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.