Google Play

Get Google Play app

Get a Google Play app with its ratings, installs, price, developer contacts, permissions and similar apps.

GET/v1/google-play/apps/{appId}
1credit
x-api-keystringheader

API key (`sfk_...`)

Parameters
3
appIdstringrequiredpath

Google Play app id (the Android package name), e.g. `com.spotify.music`. A Google Play app link is also accepted.

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

Endpoint-specific response payload.

datalookupStatus
string

`not_found` when Google Play has no such app or developer. An app removed from the store and one that never existed look the same.

one of: found, not_found

datastorefront
string

Storefront (country) the record is for.

datalanguage
string

Language of the text.

The app; null when `lookupStatus` is `not_found`.

dataappid
string

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

dataappname
string

App name.

dataappurl
string

The app's Google Play page.

dataappsummary
stringnullable

Short description under the name (up to 80 characters).

dataappdescription
stringnullable

Full store description as plain text, line breaks kept.

dataappicon
stringnullable

Icon image URL.

dataappheaderImage
stringnullable

Feature graphic shown at the top of the page.

Screenshot URLs.

dataappscreenshots[]
stringoptional

The promo video; null when the app has none.

dataappvideourl
string

Trailer player URL.

dataappvideothumbnail
stringnullable

Trailer thumbnail image URL.

The developer and the contact details they list.

dataappdeveloperid
stringnullable

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

dataappdevelopername
stringnullable

Developer name.

dataappdeveloperurl
stringnullable

The developer's Google Play page.

dataappdeveloperemail
stringnullable

Support email the developer lists.

dataappdeveloperwebsite
stringnullable

Website the developer lists.

dataappdeveloperaddress
stringnullable

Postal address the developer lists, line breaks kept.

dataappdeveloperphone
stringnullable

Phone number the developer lists.

dataappdeveloperlegalName
stringnullable

Legal name of the business behind the app, when listed.

dataappprivacyPolicyUrl
stringnullable

Privacy policy link the developer lists.

A Google Play category.

dataappprimaryGenreid
stringnullable

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

dataappprimaryGenrename
string

Category name in the requested language.

Further categories and tags the store shows, e.g. `Sandbox` or `Offline`.

dataapptags[]
stringoptional

Star ratings in this storefront.

dataappratingsaverage
numbernullable

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

dataappratingscount
integernullable

Number of ratings.

dataappratingsreviewCount
integernullable

Number of written reviews.

Ratings by number of stars.

dataappratingshistogram1
integernullable

One-star ratings.

dataappratingshistogram2
integernullable

Two-star ratings.

dataappratingshistogram3
integernullable

Three-star ratings.

dataappratingshistogram4
integernullable

Four-star ratings.

dataappratingshistogram5
integernullable

Five-star ratings.

dataappinstalls
stringnullable

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

dataappinstallsMin
integernullable

Lower bound of the install band.

dataappinstallsEstimate
integernullable

The store's own install count behind the band.

Price of the app in this storefront.

dataapppriceamount
numbernullable

Price in the storefront currency; 0 for free apps.

dataapppricecurrency
stringnullable

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

dataapppriceformatted
stringnullable

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

dataappfree
booleannullable

True for apps that cost nothing to install.

dataappinAppPurchases
stringnullable

In-app purchase price range, e.g. `$4.99 - $203.88 per item`; null when the app sells nothing inside it.

dataappcontainsAds
boolean

Whether the store says it shows ads.

dataappisEditorsChoice
booleannullable

Whether the store shows its Editors' Choice badge on the app in this storefront; null when the page header could not be read.

dataappageRating
stringnullable

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

dataappcontentDescriptors
stringnullable

Reasons behind the content rating, e.g. `Fantasy Violence`.

dataappinteractiveElements
stringnullable

Interactive elements, e.g. `Users Interact, In-Game Purchases`.

A chart the app ranks in, when the page shows one.

dataappchartPositionchart
string

Chart name, e.g. `top free music & audio`.

dataappchartPositionrank
integernullable

Position in that chart.

dataappversion
stringnullable

Current version; null when it varies with the device, as for most large apps.

dataappminimumAndroidVersion
stringnullable

Lowest Android version that runs the app; null when it varies with the device.

dataappreleasedAt
stringnullable

When the app was first released (ISO-8601, UTC).

dataappupdatedAt
stringnullable

When the app was last updated (ISO-8601, UTC).

dataapprecentChanges
stringnullable

What is new in the latest update, as plain text.

Permissions the app asks for, by group.

dataapppermissions[]group
string

Permission group, e.g. `Location`.

Each permission in the group, as the store words it.

dataapppermissions[]permissions[]
stringoptional

The data safety summary the developer declared.

dataappdataSafety[]title
string

A data safety statement, e.g. `Data is encrypted in transit`.

dataappdataSafety[]detail
stringnullable

The data types it covers, when listed.

Similar apps the page recommends.

dataappsimilarApps[]id
string

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

dataappsimilarApps[]name
string

App name.

dataappsimilarApps[]url
string

The app's Google Play page.

dataappsimilarApps[]icon
stringnullable

Icon image URL.

The developer an app is published under.

dataappsimilarApps[]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.

dataappsimilarApps[]developername
stringnullable

Developer name.

dataappsimilarApps[]developerurl
stringnullable

The developer's Google Play page.

dataappsimilarApps[]rating
numbernullable

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

Price of the app in this storefront.

dataappsimilarApps[]priceamount
numbernullable

Price in the storefront currency; 0 for free apps.

dataappsimilarApps[]pricecurrency
stringnullable

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

dataappsimilarApps[]priceformatted
stringnullable

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

dataappsimilarApps[]free
booleannullable

True for apps that cost nothing to install.

dataappsimilarApps[]summary
stringnullable

Short description shown on the store card.

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

dataappsimilarApps[]primaryGenreid
stringnullable

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

dataappsimilarApps[]primaryGenrename
string

Category name in the requested language.

dataappsimilarApps[]installs
stringnullable

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

dataappsimilarApps[]ageRating
stringnullable

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

dataappsimilarApps[]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.

dataappsimilarApps[]screenshots[]
stringoptional

Other apps by the same developer the page shows.

dataappmoreByDeveloper[]id
string

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

dataappmoreByDeveloper[]name
string

App name.

dataappmoreByDeveloper[]url
string

The app's Google Play page.

dataappmoreByDeveloper[]icon
stringnullable

Icon image URL.

The developer an app is published under.

dataappmoreByDeveloper[]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.

dataappmoreByDeveloper[]developername
stringnullable

Developer name.

dataappmoreByDeveloper[]developerurl
stringnullable

The developer's Google Play page.

dataappmoreByDeveloper[]rating
numbernullable

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

Price of the app in this storefront.

dataappmoreByDeveloper[]priceamount
numbernullable

Price in the storefront currency; 0 for free apps.

dataappmoreByDeveloper[]pricecurrency
stringnullable

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

dataappmoreByDeveloper[]priceformatted
stringnullable

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

dataappmoreByDeveloper[]free
booleannullable

True for apps that cost nothing to install.

dataappmoreByDeveloper[]summary
stringnullable

Short description shown on the store card.

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

dataappmoreByDeveloper[]primaryGenreid
stringnullable

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

dataappmoreByDeveloper[]primaryGenrename
string

Category name in the requested language.

dataappmoreByDeveloper[]installs
stringnullable

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

dataappmoreByDeveloper[]ageRating
stringnullable

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

dataappmoreByDeveloper[]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.

dataappmoreByDeveloper[]screenshots[]
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/apps/com.spotify.music" \
  -H "x-api-key: YOUR_API_KEY"

Responses

Google Play app.