Start building

Google Play Games Search API docs

Open Playground →

Start building

Send your first request

Platform API endpoint with unified authentication and usage tracking.

Production API
Platform API endpoint
https://api.sandbase.ai/v1/api/google-play/games
Authorization header
Authorization: Bearer $SANDBASE_API_KEY
# The quoted heredoc keeps Unicode and shell metacharacters unchanged.
result=$(curl --fail-with-body --silent \
  -X POST "https://api.sandbase.ai/v1/api/google-play/games" \
  -H "Authorization: Bearer $SANDBASE_API_KEY" \
  -H "Content-Type: application/json" \
  --data-binary @- <<'SANDBASE_JSON'
{
  "q": "chess",
  "gl": "us",
  "hl": "en"
}
SANDBASE_JSON
)
printf '%s\n' "$result"

2. Authentication

Set your SandBase API key in your server environment. Requests use Bearer authentication.

API key environment variable
export SANDBASE_API_KEY="YOUR_API_KEY"

Keep your key on the server. Do not expose it in browser code.

3. Parameters

hlstring

Storefront language, such as en, de, or zh-TW. Maximum 32 characters.

Default: "en"

glstring

Two-letter country code.

Default: "us"

qstring

At most 2,048 UTF-8 bytes.

chartstring

Chart 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.

next_page_tokenstring

Use the returned next_page_token with the same parameters. Excludes chart, section_page_token, and see_more_token.

section_page_tokenstring

Continue one result group using its returned token and the same parameters. Excludes the other pagination selectors and chart.

see_more_tokenstring

Open a result collection using its returned token and the same parameters. Excludes the other pagination selectors and chart.

games_categorystring

Native game category identifier, such as GAME_PUZZLE. Excludes q and an explicit store_device.

store_devicestring

Omit for the default phone storefront. An explicit selection excludes q and category.

Possible values: phone, tablet, tv, chromebook, watch, windows

timeoutnumber

Optional budget for the entire request in seconds, measured from gateway receipt until the response is ready to send. Includes admission, queueing and settlement. Must be greater than 0 and at most 90. On expiry, the call is not billed and returns 503 request_deadline_exceeded with retryable=true an

4. Response

Saved example response for this API; no live request is made when viewing it.

No saved response has been published. Run the API in Playground to inspect its response.