# Google Play Movie Lists

<p>Browse the Google Play movies store: new releases, top selling and rental deals shelves with price, offer type, genre, thumbnail, description and trailer id. US storefront. 1 credit per request.</p>

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

## 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_movies_new_release, promotion_movies_topselling, promotion_movies_deals_vod. 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_movies_new_release",
            "items": [
                {
                    "link": "https://play.google.com/store/movies/details/The_Los_Angeles_Bakers?id=FT83s6l-6kc.P",
                    "rank": 1,
                    "genre": "Drama",
                    "price": {
                        "label": "$3.99",
                        "amount": 3.99,
                        "micros": 3990000,
                        "currency": "USD"
                    },
                    "title": "The Los Angeles Bakers",
                    "thumbnail": "https://play-lh.googleusercontent.com/_pskGM9aVqpuruBqRWxVIcfFJ5NFIlCYPWdfL6Uck7iXXE9RbQK-IByjyDlkYyMIGiALg6Jwe9X380rVSw",
                    "offer_type": "Rent",
                    "product_id": "FT83s6l-6kc.P",
                    "trailer_id": "5R8tw4eAdmw.P",
                    "description": "JoJo thought she was done with her husband. Her husband disagreed. As she recalls their love, the dysfunction that drove them apart, and circumstances forcing t\u2026",
                    "original_price": null
                },
                {
                    "link": "https://play.google.com/store/movies/details/BEWARE_BOI%C3%9ANA?id=InBQMCgtriE.P",
                    "rank": 2,
                    "genre": "Thriller",
                    "price": {
                        "label": "$14.99",
                        "amount": 14.99,
                        "micros": 14990000,
                        "currency": "USD"
                    },
                    "title": "BEWARE BOI\u00daNA",
                    "thumbnail": "https://play-lh.googleusercontent.com/tvod/AONTG1epQRb7I5rzpdEqpxF66e12lB4CKYVY-3fUfgMvgX2OM0J0BR1ifS668ZL0KYjh-mf-9sZDtYcNYArkufrupJcAgiuK5A",
                    "offer_type": "Buy",
                    "product_id": "InBQMCgtriE.P",
                    "trailer_id": "SgFFu1Uwlxk.P",
                    "description": "Deep in the Amazon, a medical mission spirals into a fight for survival when Boi\u00fana, a colossal ancient predator, awakens to reclaim her domain. In the jungle w\u2026",
                    "original_price": null
                }
            ],
            "title": "New to buy or rent",
            "result_count": 2
        }
    ],
    "result_count": 2,
    "search_parameters": {
        "gl": "US",
        "hl": "en",
        "engine": "google_play_movies",
        "cluster": "promotion_movies_new_release"
    }
}
```

## 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)