List Google Play charts
List a Google Play chart: top free, paid, grossing, new or trending apps in a category.
Headers
Get your API keyAPI key (`sfk_...`)
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
`top-free`, `top-paid`, `top-grossing`, `new-free`, `new-paid` or `trending` (the fastest climbers). Default: `top-free`.
one of: top-free, top-paid, top-grossing, new-free, new-paid, trending
Category id to rank within, e.g. `GAME`, `SOCIAL` or `GAME_PUZZLE`. Default: `APPLICATION`, all apps.
Ranks to return, 1-200. Small categories rank fewer apps. Default: 100.
≥ 1 · ≤ 200
Endpoint-specific response payload.
Always `found`. A category the store ranks nothing in returns an empty list.
one of: found
Storefront the chart is for.
Language of the text.
The chart returned.
one of: top-free, top-paid, top-grossing, new-free, new-paid, trending
Category id of the chart.
Chart positions in rank order.
Position in the chart, from 1.
≥ 1
App id (package name).
A Google Play app as the store lists it in search results, charts and developer pages.
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.
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/charts?chart=top-free&category=GAME&limit=50" \
-H "x-api-key: YOUR_API_KEY"Responses
A Google Play chart.