Google Play

Search Google Play apps

Search Google Play apps by keyword, with free and paid filters.

GET/v1/google-play/apps/search
1credit
x-api-keystringheader

API key (`sfk_...`)

Parameters
5
querystringrequiredquery

Search text, e.g. `notes` or `photo editor`.

min 1 chars · max 200 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

pricestringoptionalquery

`all`, `free` (free apps only) or `paid` (paid apps only). Default: `all`.

one of: all, free, paid

cursorstringoptionalquery

Pass `page.nextCursor` from the previous response to get the next page.

min 1 chars · max 3000 chars

Response fields
39

Endpoint-specific response payload.

datalookupStatus
string

Always `found`. An empty `results` list means the store has no app for the query.

one of: found

datastorefront
string

Storefront searched.

datalanguage
string

Language of the text.

dataquery
string

The search text.

dataprice
string

Price filter used.

one of: all, free, paid

Matching apps, best match first: the store's featured exact match, then the store's results. The store sets the page size (often 30 or 50). Later pages carry fewer fields: price, installs, category and age rating are null there.

dataresults[]id
string

App id (package name), e.g. `com.spotify.music`.

dataresults[]name
string

App name.

dataresults[]url
string

The app's Google Play page.

dataresults[]icon
stringnullable

Icon image URL.

The developer an app is published under.

dataresults[]developerid
stringnullable

Developer id to pass to GET /v1/google-play/developers/{developerId}: a number for developers with their own page, otherwise the developer name.

dataresults[]developername
stringnullable

Developer name.

dataresults[]developerurl
stringnullable

The developer's Google Play page.

dataresults[]rating
numbernullable

Average star rating (1 to 5); null when not rated yet.

Price of the app in this storefront.

dataresults[]priceamount
numbernullable

Price in the storefront currency; 0 for free apps.

dataresults[]pricecurrency
stringnullable

ISO 4217 currency code, e.g. `USD`.

dataresults[]priceformatted
stringnullable

Price as the store shows it, e.g. `$6.99`; null for free apps.

dataresults[]free
booleannullable

True for apps that cost nothing to install.

dataresults[]summary
stringnullable

Short description shown on the store card.

The app's category; the id is null on cards.

dataresults[]primaryGenreid
stringnullable

Category id, e.g. `MUSIC_AND_AUDIO`; null where the store lists only the name.

dataresults[]primaryGenrename
string

Category name in the requested language.

dataresults[]installs
stringnullable

Install band as the store shows it, e.g. `1,000,000,000+`.

dataresults[]ageRating
stringnullable

Content rating, e.g. `Everyone` or `Teen`.

dataresults[]inAppPurchases
stringnullable

In-app purchase price range, e.g. `$0.99 - $49.99 per item`; null when none is shown.

Screenshot URLs shown on the card.

dataresults[]screenshots[]
stringoptional

Broad queries have more pages: pass `page.nextCursor` as `cursor` while `page.hasMore` is true, with the same query, price, country and language.

datapagehasMore
boolean

Whether another page is available.

datapagenextCursor
stringnullable

Cursor to pass in the next request when more pages exist; null on the last page.

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/apps/search?query=notes" \
  -H "x-api-key: YOUR_API_KEY"

Responses

Google Play search results.