ESPN

ESPN scoreboard

Returns games (scores, schedule, status, and odds when available) for a sport and league. The sport enum accepts football, basketball, baseball, hockey, and soccer. The league enum accepts nfl, college-football, nba, wnba, mens-college-basketball, womens-college-basketball, mlb, nhl, eng.1, esp.1, ita.1, ger.1, fra.1, usa.1, and uefa.champions; it must be valid for the chosen sport. The seasontype enum accepts 1 (preseason), 2 (regular season), 3 (postseason), and 4 (offseason).

get/espn/scoreboard

Request

  • Base URL: https://api.crawlora.net/api/v1
  • URL: https://api.crawlora.net/api/v1/espn/scoreboard
  • Auth: API key in header x-api-key

Query parameters

sport'football' | 'basketball' | 'baseball' | 'hockey' | 'soccer' required

Sport key

league'nfl' | 'college-football' | 'nba' | 'wnba' | 'mens-college-basketball' | 'womens-college-basketball' | 'mlb' | 'nhl' | 'eng.1' | 'esp.1' | 'ita.1' | 'ger.1' | 'fra.1' | 'usa.1' | 'uefa.champions' required

League key (must be valid for the sport)

datesstring

Date or range as YYYYMMDD, YYYYMMDD-YYYYMMDD, or YYYY; defaults to the current scoreboard

weekinteger

Week number (football leagues)

seasontype1 | 2 | 3 | 4

Season type

Headers

x-api-keystring required

API key required

Response

OK

codeinteger
msgstring

Example response

{
  "code": 200,
  "data": {
    "count": 14,
    "games": [
      {
        "competitors": [
          {
            "home_away": "home",
            "record": "10-2",
            "score": "27",
            "team": {
              "abbreviation": "KC",
              "display_name": "Kansas City Chiefs",
              "id": "12",
              "location": "Kansas City",
              "name": "Chiefs",
              "short_display_name": "Chiefs"
            }
          }
        ],
        "id": "401816033",
        "status": {
          "completed": true,
          "detail": "Final",
          "short_detail": "Final",
          "state": "post"
        }
      }
    ],
    "league": "nfl",
    "league_name": "National Football League",
    "season": {
      "type": 2,
      "year": 2024
    },
    "sport": "football"
  },
  "msg": "OK"
}

Changes

No recorded changes to this operation across all 2 revisions of this API.