# Google Play Book Lists

<p>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.</p>

- **Documentation:** [https://scrappa.co/docs/google-play-api/google_play_books](https://scrappa.co/docs/google-play-api/google_play_books)
- **API group:** Google Play API
- **Endpoint:** `GET https://scrappa.co/api/google/play/books`

## Authentication

Send your Scrappa API key in the `X-API-KEY` request header. Paid endpoints also support accountless x402 payments when called without an API key.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `cluster` | string | No | 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. |
| `hl` | string | No | Interface language code, for example en. Default en. |
| `gl` | string | No | Storefront country. Only US is supported (default). Other values return 422. |

## Example response

```json
{
    "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

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | A parameter failed validation, for example an unknown cluster or a country other than US. The request is not billed. |
| 503 | Google Play Upstream Unavailable | Google Play could not be fetched or the page could not be read. The request is not billed. |

## More Scrappa resources

- [API documentation](https://scrappa.co/docs)
- [Full LLM-readable API reference](https://scrappa.co/llms-full.txt)
- [OpenAPI specification](https://scrappa.co/docs/api.json)
- [Pricing](https://scrappa.co/pricing)