// request reference
Google Play Books parameters
Send query parameters with GET /api/google/play/books. 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. Omit it to browse the storefront.
Example / input hint: coffee
Filters
books_categoryNative category identifier, such as coll_1689 for children’s books or FAMILY for family movies. Excludes q.
ageRequires the children’s category: FAMILY for apps and movies, or coll_1689 for books.
AGE_RANGE1AGE_RANGE2AGE_RANGE3price1 for free books or 2 for paid books. Requires q.
12chartChart 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, 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.