Google Play

List Google Play search suggestions

List the searches Google Play suggests for the start of a query.

GET/v1/google-play/suggestions
1credit
x-api-keystringheader

API key (`sfk_...`)

Parameters
3
querystringrequiredquery

The start of a search, e.g. `spot`.

min 1 chars · max 100 chars

countrystringoptionalquery

Two-letter storefront code, e.g. `us`, `gb` or `jp`, case-insensitive. Prices, ratings, charts and search results follow it. Default: `us`.

pattern: ^[a-z]{2}$

languagestringoptionalquery

Language of the text, e.g. `en`, `de`, `pt-BR` or `ja`. Names, descriptions and labels follow it. Default: `en`.

min 2 chars · max 10 chars

Response fields
13

Endpoint-specific response payload.

datalookupStatus
string

`found` when the store suggests at least one search; `no_data` when it suggests none.

one of: found, no_data

datastorefront
string

Storefront asked.

datalanguage
string

Language of the suggestions.

dataquery
string

The text that was completed.

Searches the store suggests, best first (usually up to 5). They follow the language more than the storefront.

datasuggestions[]
stringoptional

Metadata describing the request and billing outcome.

metarequestId
string

Unique request identifier for tracing this API call.

min 1 chars

metacreditsCharged
integer

Credits charged for this request.

≥ 0

metaversion
string

Public API version that served the response.

one of: v1

metastale
booleanoptional

Present, and `true`, only when the source couldn't be reached and this is the last good answer for the same request instead, up to 24 hours old. Absent on every live answer.

one of: true

metafetchedAt
stringoptional

When a stale answer (`stale: true`) was originally fetched (ISO 8601, UTC). Absent on every live answer.

Code example

curl "https://api.socialfetch.dev/v1/google-play/suggestions?query=spot" \
  -H "x-api-key: YOUR_API_KEY"

Responses

Google Play search suggestions.