Google Play

List Google Play charts

List a Google Play chart: top free, paid, grossing, new or trending apps in a category.

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

API key (`sfk_...`)

Parameters
5
countrystringquery

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}$

languagestringquery

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

chartstringquery

`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

categorystringquery

Category id to rank within, e.g. `GAME`, `SOCIAL` or `GAME_PUZZLE`. Default: `APPLICATION`, all apps.

limitintegerquery

Ranks to return, 1-200. Small categories rank fewer apps. Default: 100.

≥ 1 · ≤ 200

Response fields
39

Endpoint-specific response payload.

datalookupStatus
string

Always `found`. A category the store ranks nothing in returns an empty list.

one of: found

datastorefront
string

Storefront the chart is for.

datalanguage
string

Language of the text.

datachart
string

The chart returned.

one of: top-free, top-paid, top-grossing, new-free, new-paid, trending

datacategory
string

Category id of the chart.

Chart positions in rank order.

dataentries[]rank
integer

Position in the chart, from 1.

≥ 1

dataentries[]id
string

App id (package name).

A Google Play app as the store lists it in search results, charts and developer pages.

dataentries[]appid
string

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

dataentries[]appname
string

App name.

dataentries[]appurl
string

The app's Google Play page.

dataentries[]appicon
stringnullable

Icon image URL.

The developer an app is published under.

dataentries[]appdeveloperid
stringnullable

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

dataentries[]appdevelopername
stringnullable

Developer name.

dataentries[]appdeveloperurl
stringnullable

The developer's Google Play page.

dataentries[]apprating
numbernullable

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

Price of the app in this storefront.

dataentries[]apppriceamount
numbernullable

Price in the storefront currency; 0 for free apps.

dataentries[]apppricecurrency
stringnullable

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

dataentries[]apppriceformatted
stringnullable

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

dataentries[]appfree
booleannullable

True for apps that cost nothing to install.

dataentries[]appsummary
stringnullable

Short description shown on the store card.

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

dataentries[]appprimaryGenreid
stringnullable

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

dataentries[]appprimaryGenrename
string

Category name in the requested language.

dataentries[]appinstalls
stringnullable

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

dataentries[]appageRating
stringnullable

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

dataentries[]appinAppPurchases
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.

dataentries[]appscreenshots[]
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/charts?chart=top-free&category=GAME&limit=50" \
  -H "x-api-key: YOUR_API_KEY"

Responses

A Google Play chart.