// request reference
Google Play Games parameters
Send query parameters with GET /api/google/play/games. Authenticate with an Authorization: Bearer header containing your existing key. Keep keys on your server, not in browser code.
The groups below list every request field, including compatibility restrictions. Read the extended reference for detailed types, defaults, parameter combinations and additional examples.
Request
qOptional query with 1 to 2,048 UTF-8 bytes of printable text. Excludes category. Uses shared Android app search. Omit q or choose games_category to browse games.
Example / input hint: coffee
Filters
games_categoryNative category identifier, such as MEDICAL or GAME_PUZZLE. Excludes q and an explicit store_device.
store_deviceOmit for the default phone storefront. An explicit selection excludes q and category.
Example / input hint: phone
phonetablettvchromebookwatchwindowschartChart identifier such as topselling_free, topselling_paid, or topgrossing. Excludes q and all pagination selectors. Apps and games charts require phone or an omitted store_device.
Localization
hlStorefront language, such as en, de, or zh-TW. Maximum 32 characters.
Example / input hint: en
glTwo-letter country code.
Example / input hint: us
Pagination
next_page_tokenUse the returned next_page_token with the same parameters. Excludes chart, section_page_token, and see_more_token.
section_page_tokenContinue one result group using its returned token and the same parameters. Excludes the other pagination selectors and chart.
see_more_tokenOpen a result collection using its returned token and the same parameters. Excludes the other pagination selectors and chart.
// response
Work with the complete JSON response
Response groups include organic_results, items_highlight, charts, litescrape_pagination. Groups and fields depend on the upstream result.
The SDK examples use raise_for_error() or raiseForError() so API errors are not mistaken for successful results.