Skip to content

Search or browse games on Google Play

POST/v1/tools/google-play.search.games/callsNeeds an API key

Returns the Google Play games that match a search, in the store's sections. Without a query, it returns the store's front page of games.

Tool google-play.search.games on Google Play. Contract version 1, released 2026-10-27.

Over REST, send the input in the body. Over MCP, pass the same input to call_tool.

Both return the full response: the call's ID, status and cost, with this tool's result in output.

Input

querystring

What to search for. Google Play searches games together with apps, so a query returns both. Left out, the store's front page of games is returned, in sections.

1 to 2048 characters.

countrystring· default us

Two-letter ISO 3166-1 country code of the storefront. Case-insensitive.

One of the 249 values of the countries list: ISO 3166-1 alpha-2 country codes, lowercase.

languagestring· default en

Two-letter ISO 639-1 language code of the storefront. Case-insensitive.

One of the 184 values of the languages list: ISO 639-1 two-letter language codes, lowercase.

next_page_tokenstring

Fetches the next page. Take it from pagination.next_page_token of the previous page, and send the same query, country and language. Not with section_page_token.

section_page_tokenstring

Loads more of one section. Take it from that section's next_page_token, and send the same query, country and language. Not with next_page_token.

Output

A successful call returns these blocks in its output. A field not marked required can be null.

sections

A list of rows. Always present, possibly empty. The results, in the sections the store groups them in, in order.

titlestring

The section's heading, such as "Indie Corner". Null for the main section, which has none.

next_page_tokenstring

Send as section_page_token to load more of this section, with the same query, country and language. Null when the section has no more.

resultsarray of objectRequired
results.product_idstringRequired

Google Play's ID of the game. Send as product_id to google-play.product or google-play.reviews.

results.titlestringRequired
results.urlstring

Address of the game's page on Google Play.

results.descriptionstring
results.image_urlstring

Address of the game's icon.

results.developer_namestring
results.ratingnumber

Average rating, out of 5.

results.categorystring

The game's category, as the store names it, such as "Puzzle".

results.installsstring

Install count as the store shows it, such as "10,000,000+". Not parsed.

results.content_ratingstring

Age rating as the store shows it, such as "Teen".

results.pricestring

The price as the store shows it, with its currency symbol, such as "$4.99". Not parsed.

results.price_amountnumber

The price as a number, in currency. 0 for a free game.

results.currencystring

Three-letter ISO 4217 currency code of price_amount.

pagination

One object. Can be null. How to fetch the next page. Null on the last page.

next_page_tokenstringRequired

Send as next_page_token to fetch the next page.