JSON POST request example
POST to https://ecll-litescrape-v3--site-api-web.modal.run/api/google/play/apps with Content-Type: application/json and your Authorization: Bearer header.
{
"q": "coffee",
"hl": "en",
"gl": "us"
}// request reference
Google Play Apps parameters
Send query parameters with GET /api/google/play/apps. 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_-]+$
apps_categoryNative app category identifier, such as MEDICAL. 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
phonetablettvchromebookwatchcarageChildren's age range. Requires apps_category=FAMILY.
Type string · GET query or POST JSON
AGE_RANGE1AGE_RANGE2AGE_RANGE3Localization
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 organic_results, _page_token, charts, items_highlight, app_highlight, 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.
Illustrative success response. Result groups and optional fields depend on upstream content.
{
"organic_results": [
{
"items": [
{
"extension": "8 items",
"format": "Ebook series",
"link": "https://play.google.com/store/books/series?id=av3XFwAAABC86M",
"product_id": "av3XFwAAABC86M",
"thumbnail": "https://play-lh.googleusercontent.com/DO9D9mcmQJ8OXHXGOFyfQWRKgzoTlKbw1Epd4kHRZmPP1G8v7vzCHT8XZGL6j4JfP3o4kmvXeK-ohgdt4-E",
"title": "Dune"
},
{
"extension": "12 books",
"format": "Ebook series",
"link": "https://play.google.com/store/books/series?id=mPnXFwAAABBO7M",
"product_id": "mPnXFwAAABBO7M",
"thumbnail": "https://play-lh.googleusercontent.com/ofs4XPMudPYM7c9pYmYLmk5vJMUtxwEV-NOaNwylrTdnf8W3mwfSavwzYDoE3iucMR65dQsOB6fAvyeJIYA",
"title": "Dune"
}
],
"see_more_link": "https://play.google.com/store/books/collection/cluster?gsr=SlBqLGJKczBrMDBmd21Ib1l6T0ZITXZURkFLcGhrQzlFTVdGdStpbmROSlRTSGM92gscCgREdW5lECwYASIAKgAwADgBQgZTZXJpZXNIALASAA%3D%3D:S:ANO1ljKoQIE",
"title": "Series"
},
{
"items": [
{
"author": "Frank Herbert",
"category": "Fiction & literature",
"currency": "USD",
"description": "A visually stunning graphic novel adaptation of Frank Herbert’s Dune Messiah , this volume brings one of science fiction’s most pivotal stories to life in a bold, immersive new format. Adapted by Brian Herbert and Kevin J. Anderson and illustrated by Michael Shelfer, Dune Messiah: Book 1 transforms the iconic sequel into a cinematic graphic experience. Rich, detailed artwork captures the scale of Arrakis and the complexity of its characters, while the visual format sharpens the story’s core tensions—power, religion, and destiny—with new immediacy. Paul Atreides is now Emperor of the known univ ?",
"extracted_price": 23.39,
"link": "https://play.google.com/store/books/details/Frank_Herbert_Dune_Messiah_Book_1?id=A2jEEQAAQBAJ",
"price": "$23.39",
"product_id": "A2jEEQAAQBAJ",
"thumbnail": "https://play.google.com/books/publisher/content/images/frontcover/A2jEEQAAQBAJ?fife",
"title": "Dune Messiah Book 1"
},
{
"author": "Frank Herbert",
"category": "Science fiction",
"currency": "USD",
"description": "Frank Herbert’s classic masterpiece—a triumph of the imagination and one of the bestselling science fiction novels of all time. Set on the desert planet Arrakis, Dune is the story of Paul Atreides—who would become known as Muad'Dib—and of a great family's ambition to bring to fruition mankind's most ancient and unattainable dream. A stunning blend of adventure and mysticism, environmentalism and politics, Dune won the first Nebula Award, shared the Hugo Award, and formed the basis of what is undoubtedly the grandest epic in science fiction.",
"extension": "Book 1",
"extracted_price": 9.99,
"link": "https://play.google.com/store/books/details/Frank_Herbert_Dune?id=p1MULH7JsTQC",
"price": "$9.99",
"product_id": "p1MULH7JsTQC",
"rating": 4.656065,
"thumbnail": "https://play.google.com/books/content/images/frontcover/p1MULH7JsTQC?fife",
"title": "Dune: Volume 1"
}
],
"see_more_link": "https://play.google.com/store/books/collection/cluster?gsr=SmtqLE11aWpxUVNITG0yc1JwSFh2eTMrVHRSNG16REw0TGNEV3ZiM0k4bXdqTEE92gs3CgREdW5lEAUYASIdKhtib29rc19zZXJpZXNfc2VhcmNoO2VwaXNvZGUqADAAOAFCBkVib29rc7ASAA%3D%3D:S:ANO1ljJnU6o",
"title": "Ebooks"
}
],
"submit_feedback_for_this_response_here": "https://ecll-litescrape-v3--site-api-web.modal.run/api/feedback/example-not-a-valid-token"
}