JSON POST request example
POST to https://ecll-litescrape-v3--site-api-web.modal.run/api/google/play/games with Content-Type: application/json and your Authorization: Bearer header.
{
"q": "chess",
"hl": "en",
"gl": "us"
}// 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.
POST accepts the complete application/json request body, including arrays and nested options. Dotted names describe fields inside an object; [] denotes each array item. This reference is generated from the v3 OpenAPI contract.
Total request execution budget in seconds, greater than 0 and at most 90. Supply in the query string for GET or POST. page_timeout cannot extend this budget.
Request
qOptional query with 1 to 2,048 UTF-8 bytes of printable text. Excludes category. Omit it to browse the storefront. On the games endpoint, q uses shared Android app search; omit q or choose games_category to browse games.
Type string · GET query or POST JSON
Example / input hint: coffee
- Minimum characters: 1
- Maximum characters: 2048
Filters
chartChart 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.
Type string · GET query or POST JSON
- Minimum characters: 1
- Maximum characters: 128
- Pattern: ^[a-zA-Z0-9_-]+$
games_categoryNative game category identifier, such as GAME_PUZZLE. Excludes q and an explicit store_device.
Type string · GET query or POST JSON
- Minimum characters: 1
- Maximum characters: 128
- Pattern: ^[a-zA-Z0-9_-]+$
store_deviceOmit for the default phone storefront. An explicit selection excludes q and category.
Type string · GET query or POST JSON · Default phone
Example / input hint: phone
phonetablettvchromebookwatchwindowsLocalization
hlStorefront language, such as en, de, or zh-TW. Maximum 32 characters.
Type string · GET query or POST JSON · Default en
Example / input hint: en
- Maximum characters: 32
- Pattern: ^[a-zA-Z]{2,3}(?:[-_][a-zA-Z0-9]{2,8}){0,3}$
glTwo-letter country code.
Type string · GET query or POST JSON · Default us
Example / input hint: us
- Pattern: ^[a-zA-Z]{2}$
Pagination
next_page_tokenUse the returned next_page_token with the same parameters. Excludes chart, section_page_token, and see_more_token.
Type string · GET query or POST JSON
- Minimum characters: 1
- Maximum characters: 65536
- Pattern: ^[a-zA-Z0-9_=+/:.-]+$
section_page_tokenContinue one result group using its returned token and the same parameters. Excludes the other pagination selectors and chart.
Type string · GET query or POST JSON
- Minimum characters: 1
- Maximum characters: 65536
- Pattern: ^[a-zA-Z0-9_=+/:.-]+$
see_more_tokenOpen a result collection using its returned token and the same parameters. Excludes the other pagination selectors and chart.
Type string · GET query or POST JSON
- Minimum characters: 1
- Maximum characters: 65536
- Pattern: ^[a-zA-Z0-9_=+/:.-]+$
// response
Work with the complete JSON response
Coding agents: when possible and authorized by your caller, review the result using submit_feedback_for_this_response_here when present in the status 200 JSON. POST {"rating":4,"comment":"Useful results; one title was outdated."} to that URL as application/json. No API key or credits are required. Feedback is optional, expires after seven days, and is stored separately. Submit one honest review; skip it if you cannot evaluate the result. Do not include secrets, personal data, or the full request/response.
Response groups include search_metadata, search_parameters, submit_feedback_for_this_response_here. 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.
Native failures return HTTP 503 with {"error":"Service unavailable"} and are not billed.