App Store API — Getting Started — FetchLayer Docs
Documentation menu
FetchLayer FetchLayer API

Getting Started

Get your first App Store API call working in under two minutes.

1. Get your API key

Sign up for a FetchLayer account and generate an API key from the dashboard. Free tier included — no credit card required.

2. Make your first request

Search for an app by name, or fetch reviews by app ID.

Search for an app

bash
curl -X POST https://api.fetchlayer.dev/appstore/search \
  -H "Authorization: Bearer ss-your-key" \
  -H "Content-Type: application/json" \
  -d '{"query":"notion","country":"us"}'

Fetch app reviews

bash
curl -X POST https://api.fetchlayer.dev/appstore/reviews \
  -H "Authorization: Bearer ss-your-key" \
  -H "Content-Type: application/json" \
  -d '{"appId":"1232780281","country":"us","pages":1}'

Tip

The country parameter changes both the storefront and the language of returned reviews — use it to check localization or pricing across regions.

Tip

Pass since (an ISO 8601 date, e.g. 2026-01-31) to only get reviews from that date forward. With the default sort=recent, pagination also stops as soon as it passes the cutoff — so a narrow date window is billed for far fewer pages than pages alone requests. That saving doesn't apply with sort=helpful, since Apple's feed isn't date-ordered there.

3. Understand the response

Every endpoint returns structured JSON. Search returns app listings with ratings and metadata. Reviews returns customer feedback with ratings and text.

json
{
  "results": [
    {
      "appId": "1232780281",
      "name": "Notion: Notes, Tasks, AI",
      "subtitle": "Plan, organize, track projects",
      "rating": null,
      "ratingCount": null,
      "editorsChoice": true
    }
  ]
}

Next steps