Google Sports API

Our Google Sports API allows you to scrape results from Google Sports pages. It supports game, league, and team results across football, basketball, baseball, cricket, American football, ice hockey, and rugby sports.

The API endpoint is https://serpapi.com/search?engine=google_sports

Head to the playground for a live and interactive demo.

API Parameters

Search Query

kgmid

Required

Parameter defines the Google Knowledge Graph ID of the selected entity type. It can be found in Google Search API, Google Sports API, or on Wikidata as "Freebase ID".

Localization

Optional

Parameter defines the country to use for the Google search. It's a two-letter country code (e.g., us for the United States, uk for United Kingdom, or fr for France). Head to the Google countries page for a full list of supported Google countries.

Optional

Parameter defines the language to use for the Google search. It's a two-letter language code (e.g., en for English, es for Spanish, or fr for French). Head to the Google languages page for a full list of supported Google languages.

Time Period

mpd

Optional

Parameter defines the middle time of the league and team games. Games before and after the specified time will be returned.

Format (ISO8601 UTC): YYYY-MM-DDTHH:mm:ssZ
Example: 2026-05-29T12:30:00Z

Parameter cannot be used with moa and mob parameters.

moa

Optional

Parameter defines the earliest time of the league and team games. Games after the specified time will be returned.

Format (ISO8601 UTC): YYYY-MM-DDTHH:mm:ssZ
Example: 2026-05-29T12:30:00Z

Parameter cannot be used with mpd parameter.
Parameter can be used with mob parameter, but should not be later.

mob

Optional

Parameter defines the latest time of the league and team games. Games before the specified time will be returned.

Format (ISO8601 UTC): YYYY-MM-DDTHH:mm:ssZ
Example: 2026-05-29T12:30:00Z

Parameter cannot be used with mpd parameter.
Parameter can be used with moa parameter, but should not be earlier.

Advanced Parameters

season_kgmid

Optional

Parameter defines the Google Knowledge Graph ID of the specific standings season and should be used alongside the main league or team kgmid.

Available seasons can be found in Google Sports API standings results or on Wikidata as "Freebase ID".

Parameter can be used as a standalone kgmid parameter to fetch tabs other than standings.

Required

Parameter defines the sport of the selected entity type.

Options:
ft - Football
bs - Basketball
bb - Baseball
cr - Cricket
af - American football
ih - Ice hockey
rg - Rugby

type

Required

Parameter defines the entity type.

Options:
game - Game
league - League
team - Team

tab

Optional

Parameter defines the tab on the page of the selected entity type.

Options:
gm - League/Team - Games
sn - League/Team - Standings
pl - League/Team - Players
br - League/Team - Brackets
st - League - Stats
rn - League - Rankings
ov - Game - Overview (American football)

Parameter is required for league and team entity type.
Parameter is optional for game entity type and should be used only with American football sp value.

Serpapi Parameters

engine

Required

Set parameter to google_sports to use the Google Sports API engine.

no_cache

Optional

Parameter will force SerpApi to fetch the Google Sports results even if a cached version is already present. A cache is served only if the query and all parameters are exactly the same. Cache expires after 1h. Cached searches are free, and are not counted towards your searches per month. It can be set to false (default) to allow results from the cache, or true to disallow results from the cache. no_cache and async parameters should not be used together.

async

Optional

Parameter defines the way you want to submit your search to SerpApi. It can be set to false (default) to open an HTTP connection and keep it open until you got your search results, or true to just submit your search to SerpApi and retrieve them later. In this case, you'll need to use our Searches Archive API to retrieve your results. async and no_cache parameters should not be used together. async should not be used on accounts with Ludicrous Speed enabled.

zero_trace

Optional

Enterprise only. Parameter enables ZeroTrace mode. It can be set to false (default) or true. Enable this mode to skip storing search parameters, search files, and search metadata on our servers. This may make debugging more difficult.

api_key

Required

Parameter defines the SerpApi private key to use.

output

Optional

Parameter defines the final output you want. It can be set to json (default) to get a structured JSON of the results, or html to get the raw html retrieved.

API Results

JSON Results

JSON output includes structured data for Game Results, League Results and Team Results.

A search status is accessible through search_metadata.status. It flows this way: Processing -> Success || Error. If a search has failed, error will contain an error message. search_metadata.id is the search ID inside SerpApi.

HTML Results

HTML output is useful to debug JSON results or support features not supported yet by SerpApi.
HTML output gives you the raw HTML results from Google Sports.

JSON structure overview

{
  ...
  "game_results": {
    // please refer to Game Results page for the detailed structure
  },
  "league_results": {
    // please refer to League Results page for the detailed structure
  },
  "team_results": {
    // please refer to Team Results page for the detailed structure
  },
}