Skip to content
Docs

Sports schedules

One day of games for the NFL, NBA, MLB, NHL and major soccer leagues.One league-day of games: teams, start time, venue name, city and country, indoor flag, status and attendance on completed games. MLB adds stadium capacity and coordinates.
Look up by
A league code (nfl, nba, mlb, nhl, epl and others) and a day; empty means the current day or week
Coverage
NFL, NBA, MLB, NHL and major soccer leagues
Cost
1 credit a call; failed and empty calls are free
Endpoints
1 endpoint
  • Search

Endpoints

Example

Sports schedule, with POST /v1/events/sports/schedule. Set SCRAPERCOMPANY_API_KEY to your key and run it; the full parameter list is in the API reference.

curl -X POST "https://api.scrapercompany.com/v1/events/sports/schedule" \
  -H "x-api-key: $SCRAPERCOMPANY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "league": "string"
  }'
200 response
{
  "search_parameters": {
    "engine": "sports_schedule",
    "league": "mlb",
    "date_start": "2026-11-30"
  },
  "games": [
    {
      "id": "401816017",
      "league": "mlb",
      "date": "2026-07-04T17:35Z",
      "name": "Minnesota Twins at New York Yankees",
      "short_name": "MIN @ NYY",
      "home_team": "New York Yankees",
      "away_team": "Minnesota Twins",
      "venue_name": "Yankee Stadium",
      "venue_city": "Bronx",
      "venue_indoor": false,
      "attendance": 40156,
      "status": "STATUS_FINAL",
      "url": "https://www.espn.com/mlb/game/_/gameId/401816017",
      "capacity": 46537,
      "venue_latitude": 40.829659,
      "venue_longitude": -73.926186
    }
  ],
  "count": 15,
  "league": "mlb"
}

Try it on your key

Good to know

  • 1 credit a league-day; a day with no games is free.

Concerts, club nights, sports, trade fairs, races and university dates by city, with ticket prices on the resale market.

Or browse every data source.

Questions about this page?

Send the page link and your question, and the team will answer.

Email support