Search Google Play apps
Search Google Play apps by keyword, with free and paid filters.
Headers
Get your API keyAPI key (`sfk_...`)
Search text, e.g. `notes` or `photo editor`.
min 1 chars · max 200 chars
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}$
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
`all`, `free` (free apps only) or `paid` (paid apps only). Default: `all`.
one of: all, free, paid
Pass `page.nextCursor` from the previous response to get the next page.
min 1 chars · max 3000 chars
Endpoint-specific response payload.
Always `found`. An empty `results` list means the store has no app for the query.
one of: found
Storefront searched.
Language of the text.
The search text.
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.
App id (package name), e.g. `com.spotify.music`.
App name.
The app's Google Play page.
Icon image URL.
The developer an app is published under.
Developer id to pass to GET /v1/google-play/developers/{developerId}: a number for developers with their own page, otherwise the developer name.
Developer name.
The developer's Google Play page.
Average star rating (1 to 5); null when not rated yet.
Price of the app in this storefront.
Price in the storefront currency; 0 for free apps.
ISO 4217 currency code, e.g. `USD`.
Price as the store shows it, e.g. `$6.99`; null for free apps.
True for apps that cost nothing to install.
Short description shown on the store card.
The app's category; the id is null on cards.
Category id, e.g. `MUSIC_AND_AUDIO`; null where the store lists only the name.
Category name in the requested language.
Install band as the store shows it, e.g. `1,000,000,000+`.
Content rating, e.g. `Everyone` or `Teen`.
In-app purchase price range, e.g. `$0.99 - $49.99 per item`; null when none is shown.
Screenshot URLs shown on the card.
Broad queries have more pages: pass `page.nextCursor` as `cursor` while `page.hasMore` is true, with the same query, price, country and language.
Whether another page is available.
Cursor to pass in the next request when more pages exist; null on the last page.
Metadata describing the request and billing outcome.
Unique request identifier for tracing this API call.
min 1 chars
Credits charged for this request.
≥ 0
Public API version that served the response.
one of: v1
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
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.