Search by app name or keyword. Returns matching apps with ratings, developer, subtitle, category, and screenshots. Filter by platform (iPhone, iPad, Mac, Apple TV, Apple Watch, Apple Vision Pro) and country.

POST /search Search

https://api.fetchlayer.dev/appstore/search

OpenAPI JSON

Headers

Authorization string required

Bearer token — your FetchLayer API key.

Parameters

query string required

App name or keyword to search.

country string optional

Two-letter country code (e.g. us, gb, jp). (default: us)

platform string optional

Filter by platform: iphone, ipad, mac, appletv, watch, realityDevice.

geo string optional

Two-letter geo code for regional results.

Response Fields

search

Search the App Store

results[].id string

App Store app ID.

results[].name string

App name.

results[].developer string

Developer name.

results[].subtitle string

Short app description/tagline.

results[].rating number

Average star rating.

results[].ratingCount number

Total number of ratings.

results[].category string

Primary App Store category.

results[].price number

Price in local currency (0 = free).

results[].screenshots string[]

Screenshot URLs.

results[].editorsChoice boolean

Whether the app has been selected as an Editor's Choice.

results[].url string

App Store listing URL.

Request

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"}'

import { FetchLayer } from '@fetchlayer/appstore';

const client = new FetchLayer({ apiKey: 'ss-your-key' });

const result = await client.search({
  "query": "notion",
  "country": "us"
});

Response

{
  "results": [
    {
      "id": "1234567890",
      "name": "Notion",
      "developer": "Notion Labs",
      "rating": 4.8,
      "ratingCount": 45000,
      "category": "Productivity",
      "price": 0,
      "url": "https://apps.apple.com/us/app/notion/id1234567890"
    }
  ]
}

{
  "error": "Invalid API key"
}