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

# Get ESPN scores, schedules and betting lines for a league

> Returns a league's `games` for a day (today by default) or a date range: `startTime`, `status` (`state` is `pre`, `in` or `post`), `venue`, `broadcasts`, `url`, and `home` and `away` with the team, `score`, `record`, `linescores`, `leaders` and `probables`. Tournament and field sports return the same game shape: a tennis event lists each match with its `draw` and `round`, a fight card each bout, and golf or racing has one game with a `competitors` field. Where ESPN carries betting lines, `odds` gives each provider's `details`, `spread`, `overUnder`, `moneyline`, `pointSpread` and `total`, with American prices as numbers and `open` and `close` quotes. A day without games, such as the off-season, returns an empty `games` array with a `message`. ESPN groups games by US Eastern day.



## OpenAPI

````yaml /api-reference/openapi.json post /sports/espn-scoreboard
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/espn-scoreboard:
    post:
      tags:
        - Plugins
      summary: Get ESPN scores, schedules and betting lines for a league
      description: >-
        Returns a league's `games` for a day (today by default) or a date range:
        `startTime`, `status` (`state` is `pre`, `in` or `post`), `venue`,
        `broadcasts`, `url`, and `home` and `away` with the team, `score`,
        `record`, `linescores`, `leaders` and `probables`. Tournament and field
        sports return the same game shape: a tennis event lists each match with
        its `draw` and `round`, a fight card each bout, and golf or racing has
        one game with a `competitors` field. Where ESPN carries betting lines,
        `odds` gives each provider's `details`, `spread`, `overUnder`,
        `moneyline`, `pointSpread` and `total`, with American prices as numbers
        and `open` and `close` quotes. A day without games, such as the
        off-season, returns an empty `games` array with a `message`. ESPN groups
        games by US Eastern day.
      operationId: espn_scoreboard_sports_espn_scoreboard_post
      parameters:
        - name: sport
          in: query
          required: true
          schema:
            type: string
            description: >-
              ESPN's sport path, e.g. 'basketball', 'football', 'baseball',
              'hockey', 'soccer', 'tennis', 'golf', 'mma', 'racing'.
            title: Sport
          description: >-
            ESPN's sport path, e.g. 'basketball', 'football', 'baseball',
            'hockey', 'soccer', 'tennis', 'golf', 'mma', 'racing'.
        - name: league
          in: query
          required: true
          schema:
            type: string
            description: >-
              ESPN's league path within the sport, e.g. 'nba', 'wnba',
              'mens-college-basketball', 'nfl', 'college-football', 'mlb',
              'nhl', 'atp', 'pga', 'ufc', 'f1', or a soccer code such as
              'eng.1', 'esp.1', 'usa.1', 'uefa.champions'.
            title: League
          description: >-
            ESPN's league path within the sport, e.g. 'nba', 'wnba',
            'mens-college-basketball', 'nfl', 'college-football', 'mlb', 'nhl',
            'atp', 'pga', 'ufc', 'f1', or a soccer code such as 'eng.1',
            'esp.1', 'usa.1', 'uefa.champions'.
        - name: date
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: >-
              A day (YYYY-MM-DD or YYYYMMDD) or a range (YYYYMMDD-YYYYMMDD).
              Leave blank for today.
            title: Date
          description: >-
            A day (YYYY-MM-DD or YYYYMMDD) or a range (YYYYMMDD-YYYYMMDD). Leave
            blank for today.
        - name: group
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: >-
              ESPN's group id for college leagues, e.g. '80' for all FBS
              football or '50' for all Division I men's basketball.
            title: Group
          description: >-
            ESPN's group id for college leagues, e.g. '80' for all FBS football
            or '50' for all Division I men's basketball.
        - 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 `league` and a `games` array.
          content:
            application/json:
              schema: {}
        '400':
          description: >-
            Bad `sport`, `league`, `date` or `group`, or an invalid proxy
            country.
        '404':
          description: ESPN has no such sport or league.
        '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.