Apple App Store

Get Apple App Store developer

Get an App Store developer and every app they publish.

GET/v1/apple-app-store/developers/{developerId}
1credit
x-api-keystringheader

API key (`sfk_...`)

Parameters
3
developerIdstringrequiredpath

App Store developer id, e.g. `284882218` for Meta Platforms. It is the `developer.id` on every app.

pattern: ^(?:[iI][dD])?\d{1,12}$

countrystringoptionalquery

Two-letter storefront code, e.g. `us`, `gb` or `jp`, case-insensitive. Prices, ratings, reviews and text are specific to it. A code Apple does not run a store for is refused. Default: `us`.

pattern: ^[a-zA-Z]{2}$

languagestringoptionalquery

Language of the text, as `ll-cc`, e.g. `es-mx` or `ja-jp`. Changes the language of descriptions and price labels inside the storefront. Default: the storefront's own language.

pattern: ^[a-z]{2}[-_][a-z]{2}$

Response fields
77

Endpoint-specific response payload.

datalookupStatus
string

`not_found` when the app, developer or storefront has no match. An app removed from the store, one that never existed and one not offered in this storefront all look the same.

one of: found, not_found

datastorefront
string

Storefront the apps are listed in.

An App Store developer.

datadeveloperid
integer

App Store developer id.

datadevelopername
string

Developer name.

datadeveloperurl
stringnullable

The developer's App Store page.

Main genre; Apple lists one for only a few developers.

datadeveloperprimaryGenreid
integer

App Store genre id, e.g. `6005`.

datadeveloperprimaryGenrename
string

Genre name in the storefront language.

The developer's apps in this storefront, Mac apps included.

dataapps[]id
integer

App Store app id.

dataapps[]bundleId
string

Bundle id, e.g. `com.facebook.Facebook`.

dataapps[]name
string

App name.

dataapps[]url
string

The app's App Store page.

`ios` for iPhone and iPad apps, `mac` for Mac apps.

any of: ios, mac (comma-separated)

dataapps[]platforms[]
stringoptional

Platform family the app is sold on.

one of: ios, mac

Device families the app supports. Empty for Mac apps. An iPad-only app lists just `ipad`.

any of: iphone, ipad, ipod (comma-separated)

dataapps[]deviceFamilies[]
stringoptional

Device family the app runs on.

one of: iphone, ipad, ipod

The developer an app is published under.

dataapps[]developerid
integer

App Store developer id.

dataapps[]developername
string

Developer name.

dataapps[]developerurl
stringnullable

The developer's App Store page.

The seller of record.

dataapps[]sellername
string

Legal seller name. Differs from the developer name for about a third of apps.

dataapps[]sellerurl
stringnullable

The seller's website; null when none is listed.

Price of the app in this storefront.

dataapps[]priceamount
numbernullable

Price in the storefront currency; 0 for free apps. Null when Apple lists no price (some Apple Arcade games).

dataapps[]pricecurrency
stringnullable

ISO 4217 currency code.

dataapps[]priceformatted
stringnullable

Price as the App Store displays it, in the storefront language, e.g. `Free` or `$4.99`.

Star ratings in this storefront. Apple keeps one count per storefront; there is no worldwide total.

dataapps[]ratingsaverage
numbernullable

Average star rating (0 to 5); null when nobody has rated.

dataapps[]ratingscount
integer

Number of ratings in this storefront; 0 when none.

Ratings that apply to the current version only.

dataapps[]ratingscurrentVersionaverage
numbernullable

Average rating of the current version; null when it has no ratings.

dataapps[]ratingscurrentVersioncount
integer

Ratings of the current version in this storefront.

dataapps[]ageRating
stringnullable

Age rating such as `4+` or `17+`. The app route and the details route return the current store tier when it is available; app records inside list responses can still carry Apple's older tier.

Content descriptors behind the age rating, in the storefront language.

dataapps[]contentAdvisories[]
stringoptional

All genres.

dataapps[]genres[]id
integer

App Store genre id, e.g. `6005`.

dataapps[]genres[]name
string

Genre name in the storefront language.

An App Store genre (category).

dataapps[]primaryGenreid
integer

App Store genre id, e.g. `6005`.

dataapps[]primaryGenrename
string

Genre name in the storefront language.

The version currently on sale.

dataapps[]currentVersionversion
string

Version string.

dataapps[]currentVersionreleasedAt
stringnullable

When this version was released (ISO-8601).

dataapps[]currentVersionnotes
stringnullable

Release notes; null when the developer wrote none.

dataapps[]releasedAt
stringnullable

When the app first went on sale (ISO-8601).

dataapps[]minimumOsVersion
stringnullable

Lowest OS version that runs the app.

dataapps[]fileSizeBytes
integernullable

Download size in bytes.

Language codes the app supports, as Apple lists them (e.g. `EN`, `ZH`).

dataapps[]languages[]
stringoptional

Feature flags Apple lists, e.g. `iosUniversal`, `gameCenter`.

dataapps[]features[]
stringoptional
dataapps[]gameCenter
boolean

Whether the app supports Game Center.

dataapps[]supportsDeviceLicensing
boolean

Whether Apple Business Manager can license it per device.

dataapps[]description
stringnullable

Store description (up to 4,000 characters).

Icon image URLs hosted by Apple.

dataapps[]iconurl60
stringnullable

60 px icon.

dataapps[]iconurl100
stringnullable

100 px icon.

dataapps[]iconurl512
stringnullable

512 px icon.

Screenshot URLs hosted by Apple.

iPhone screenshots.

dataapps[]screenshotsiphone[]
stringoptional

iPad screenshots.

dataapps[]screenshotsipad[]
stringoptional

Apple TV screenshots.

dataapps[]screenshotsappleTv[]
stringoptional

Mac screenshots.

dataapps[]screenshotsmac[]
stringoptional
datatruncated
boolean

True when the list could not be completed and some apps are missing.

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

Code example

curl "https://api.socialfetch.dev/v1/apple-app-store/developers/284882218" \
  -H "x-api-key: YOUR_API_KEY"

Responses

App Store developer and apps.