Browse the Google Play books store: deals, monthly bestsellers, new releases and seasonal shelves with author, rating, price, list price and release date. US storefront. 1 credit per request.
Run this endpoint
Endpoint
Parameters
Start with the required fields, then add optional filters only when your use case needs them.
Runnable path
This endpoint has no required query parameters.
3 optional filters available.
string
Optional
Return one shelf only. Allowed: promotion_ebook_deals_purchase, promotion_ebook_monthly_books, promotion_ebook_new_releases, promotion_10024d8_big_books_month. Default: all shelves.
promotion_ebook_new_releases
string
Optional
Interface language code, for example en. Default en.
en
string
Optional
Storefront country. Only US is supported (default). Other values return 422.
us
Response Schema
Example response fields are illustrative; inspect the JSON before integrating.
Example response fields
Scan these fields before integrating.
clusters
result_count
search_parameters
Common clusters fields
id
items
title
result_count
{
"clusters": [
{
"id": "promotion_ebook_deals_purchase",
"items": [
{
"link": "https://play.google.com/store/books/details/Andy_Weir_The_Martian?id=MQeHAAAAQBAJ",
"rank": 1,
"genre": "Science fiction",
"price": {
"label": "$2.99",
"amount": 2.99,
"micros": 2990000,
"currency": "USD"
},
"title": "The Martian: A Novel",
"author": "Andy Weir",
"rating": 4.74,
"thumbnail": "https://play.google.com/books/publisher/content/images/frontcover/MQeHAAAAQBAJ?fife",
"offer_type": "Buy",
"product_id": "MQeHAAAAQBAJ",
"description": "#1 NEW YORK TIMES BESTSELLER \u2022 NOW A MAJOR MOTION PICTURE\n\nA mission to Mars. A freak accident. One man\u2019s struggle to survive. From the author of Project Hail M\u2026",
"release_date": "Feb 2014",
"original_price": {
"label": "$8.99",
"amount": 8.99,
"micros": 8990000,
"currency": "USD"
}
},
{
"link": "https://play.google.com/store/books/details/George_Lucas_Star_Wars_Trilogy?id=FHRCsi_fYjUC",
"rank": 2,
"genre": "Science fiction",
"price": {
"label": "$2.99",
"amount": 2.99,
"micros": 2990000,
"currency": "USD"
},
"title": "Star Wars Trilogy",
"author": "George Lucas",
"rating": 4.56,
"thumbnail": "https://play.google.com/books/content/images/frontcover/FHRCsi_fYjUC?fife",
"offer_type": "Buy",
"product_id": "FHRCsi_fYjUC",
"description": "This thrilling collection contains the novels of all three classic Star Wars films\u2014Star Wars: A New Hope, Star Wars: The Empire Strikes Back, and Star Wars: Ret\u2026",
"release_date": "Jun 2011",
"original_price": {
"label": "$8.99",
"amount": 8.99,
"micros": 8990000,
"currency": "USD"
}
}
],
"title": "Deals under $5",
"result_count": 2
}
],
"result_count": 2,
"search_parameters": {
"gl": "US",
"hl": "en",
"engine": "google_play_books",
"cluster": "promotion_ebook_new_releases"
}
}Errors
Handle these documented responses before retrying or showing customer-facing failures.
Validation Error
A parameter failed validation, for example an unknown cluster or a country other than US. The request is not billed.
Google Play Upstream Unavailable
Google Play could not be fetched or the page could not be read. The request is not billed.
{
"error": "Google Play data is temporarily unavailable.",
"retryable": true,
"error_code": "google_play_upstream_unavailable"
}Generate Code with AI
Copy a ready-made prompt with all the endpoint details, parameters, and example responses. Paste it into ChatGPT, Claude, or any AI assistant to instantly generate working code.
Try It Live
Test this endpoint in our interactive playground with real data.