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.
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_movies_new_release, promotion_movies_topselling, promotion_movies_deals_vod. Default: all shelves.
promotion_movies_new_release
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_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
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.