Google Play Suggestions API
The searches Google Play suggests for the start of a query, in any language.
GET /v1/google-play/suggestions1 credit Failed requests are free
About this endpoint
GET /v1/google-play/suggestions takes a query (the start of a search, such as spot), an optional country and language. data.suggestions lists the searches the store suggests, best first, usually up to 5. data.lookupStatus is found when there is at least one and no_data when there is none.
Suggestions follow the language far more than the country, so set language to the market you are researching.
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 Suggestions API FAQ
What is this useful for?
Keyword research for app store optimisation: the suggestions are the searches people start typing.
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.
Why are suggestions the same in two countries?
They follow the language more than the storefront. Change language to see another market's suggestions.
What if nothing is suggested?
lookupStatus is no_data and suggestions is empty.
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
- ChartsGET /v1/google-play/charts
- CategoriesGET /v1/google-play/categories
- StorefrontsGET /v1/google-play/storefronts
- LanguagesGET /v1/google-play/languages