Apple App Store

List Apple App Store in-app purchases

List in-app purchases and subscriptions an Apple App Store app sells.

GET/v1/apple-app-store/apps/{appId}/in-app-purchases
1credit
x-api-keystringheader

API key (`sfk_...`)

Parameters
3
appIdstringrequiredpath

Numeric App Store app id, e.g. `284882215`. An id with the `id` prefix used in App Store links (`id284882215`) is also accepted.

min 1 chars · max 155 chars

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

pageintegeroptionalquery

Page number (1-based), 10 products a page. The details route carries only the first 10; this list goes on to the end, and a large app can list thousands. The order can change, so de-duplicate on `id`. Default: 1.

≥ 1 · ≤ 1000

Response fields
35

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 prices are for.

dataappId
integer

The app id asked for.

Products on this page.

dataitems[]id
string

Product id in the store.

dataitems[]productId
stringnullable

The developer's product identifier, e.g. `com.example.app.gems100`.

dataitems[]name
string

Product name.

dataitems[]description
stringnullable

What the product gives.

Price in this storefront.

dataitems[]priceamount
numbernullable

Price in the storefront currency.

dataitems[]priceformatted
stringnullable

Price as the App Store displays it, e.g. `$1.99`.

dataitems[]pricecurrency
stringnullable

ISO 4217 currency code.

dataitems[]isSubscription
boolean

Whether it is an auto-renewing subscription.

dataitems[]recurringPeriod
stringnullable

Renewal period of a subscription as an ISO-8601 duration, e.g. `P1M`.

Introductory or promotional offers on a subscription.

dataitems[]introOffers[]type
string

Offer type, e.g. `IntroOffer`.

dataitems[]introOffers[]mode
stringnullable

e.g. `FreeTrial`.

dataitems[]introOffers[]price
numbernullable

Offer price.

dataitems[]introOffers[]formatted
stringnullable

Displayed offer price.

dataitems[]introOffers[]period
stringnullable

Offer length as an ISO-8601 duration.

dataitems[]familyShareable
boolean

Whether Family Sharing covers it.

The subscription group, for subscriptions.

dataitems[]subscriptionFamilyid
string

Subscription group id.

dataitems[]subscriptionFamilyname
stringnullable

Subscription group name.

dataitems[]subscriptionFamilyrank
integernullable

Position in the group.

dataitems[]url
stringnullable

The product's store link.

Pagination state for the current page.

datapagepage
integer

Current page number (1-based).

≥ 0

datapagehasMore
boolean

Whether another page is available.

datapagenextPage
integernullable

Next page number when more pages exist; null on the last page.

≥ 0

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/apps/284882215/in-app-purchases" \
  -H "x-api-key: YOUR_API_KEY"

Responses

App Store in-app purchases page.