Google Play Storefronts API
Every country Google Play serves, with the code to pass as country.
GET /v1/google-play/storefronts1 credit Failed requests are free
About this endpoint
GET /v1/google-play/storefronts takes no parameters. data.storefronts lists every country with its two-letter country code and English name. Every other Google Play route takes one of these codes as country; prices, ratings, charts and search results follow it.
Price
From $1.35 per 1,000 requests
1 credit per request. Failed requests are free.
- Scale pack
- $1.64 / 1,000
- Growth pack
- $2.36 / 1,000
The lowest rate is on annual plans; packs are pay as you go.
Example request
Send your API key in the x-api-key header. New accounts get 100 free credits, no card needed.
Example response
A 200 response. Live responses have the same shape with current data.
Google Play Storefronts API FAQ
What happens with a country not on the list?
The request is refused with a 400 before any work, and costs nothing.
How many credits does it cost?
Pricing is documented on the operation in the API registry (shown on this page). Confirm on every response with meta.creditsCharged: that field is the billing source of truth.
Is China on the list?
No. Google Play is not offered in mainland China, Cuba, Iran, North Korea or Syria.
Is the country case-sensitive?
No: US and us are the same storefront.
Other Google Play endpoints
- AppGET /v1/google-play/apps/{appId}
- ReviewsGET /v1/google-play/apps/{appId}/reviews
- DeveloperGET /v1/google-play/developers/{developerId}
- SearchGET /v1/google-play/apps/search
- Search suggestionsGET /v1/google-play/suggestions
- ChartsGET /v1/google-play/charts
- CategoriesGET /v1/google-play/categories
- LanguagesGET /v1/google-play/languages