Search Apple App Store
Search the App Store for apps by keyword in any storefront, up to 200 results.
Headers
Get your API keyAPI key (`sfk_...`)
Search text.
min 1 chars · max 200 chars
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}$
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}$
Where to search: `iphone` (iPhone and iPad apps), `ipad` or `mac`. Default: `iphone`.
one of: iphone, ipad, mac
Results to return, 1-200. Search often has 10 to 20 percent fewer results than asked for, so a shorter list is not an error. Default: 50.
≥ 1 · ≤ 200
Endpoint-specific response payload.
Always `found`. The search is fuzzy: a query with no real match can still return loosely related apps, so check `results[].name`; an empty list means nothing came back.
one of: found
Storefront searched.
The search text.
Platform searched.
one of: iphone, ipad, mac
Matching apps, best match first. A nonsense query can still return unrelated apps.
App Store app id.
Bundle id, e.g. `com.facebook.Facebook`.
App name.
The app's App Store page.
`ios` for iPhone and iPad apps, `mac` for Mac apps.
any of: ios, mac (comma-separated)
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)
Device family the app runs on.
one of: iphone, ipad, ipod
The developer an app is published under.
App Store developer id.
Developer name.
The developer's App Store page.
The seller of record.
Legal seller name. Differs from the developer name for about a third of apps.
The seller's website; null when none is listed.
Price of the app in this storefront.
Price in the storefront currency; 0 for free apps. Null when Apple lists no price (some Apple Arcade games).
ISO 4217 currency code.
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.
Average star rating (0 to 5); null when nobody has rated.
Number of ratings in this storefront; 0 when none.
Ratings that apply to the current version only.
Average rating of the current version; null when it has no ratings.
Ratings of the current version in this storefront.
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.
All genres.
App Store genre id, e.g. `6005`.
Genre name in the storefront language.
An App Store genre (category).
App Store genre id, e.g. `6005`.
Genre name in the storefront language.
The version currently on sale.
Version string.
When this version was released (ISO-8601).
Release notes; null when the developer wrote none.
When the app first went on sale (ISO-8601).
Lowest OS version that runs the app.
Download size in bytes.
Language codes the app supports, as Apple lists them (e.g. `EN`, `ZH`).
Feature flags Apple lists, e.g. `iosUniversal`, `gameCenter`.
Whether the app supports Game Center.
Whether Apple Business Manager can license it per device.
Store description (up to 4,000 characters).
Icon image URLs hosted by Apple.
60 px icon.
100 px icon.
512 px icon.
Screenshot URLs hosted by Apple.
iPhone screenshots.
iPad screenshots.
Apple TV screenshots.
Mac screenshots.
Search has no paging: one query returns up to 200 apps.
Current page number (1-based).
≥ 0
Whether another page is available.
Next page number when more pages exist; null on the last page.
≥ 0
Metadata describing the request and billing outcome.
Unique request identifier for tracing this API call.
min 1 chars
Credits charged for this request.
≥ 0
Public API version that served the response.
one of: v1
Code example
curl "https://api.socialfetch.dev/v1/apple-app-store/apps/search?query=photo%20editor" \
-H "x-api-key: YOUR_API_KEY"Responses
App Store search results.