App search
5 credits/v1/app_store/app-searchKeyword search on Apple App Store. App cards with ids for info and reviews. Advanced tier (5 credits).
query, country, language, depth
Apple App Store APIGet App Store app and review data with one API
Fetch Apple App Store search, app detail, reviews, charts, and reference lists as structured JSON with one SocialCrawl API key. Shared app schema. Reads are priced in credits.
/v1/app_store
9 active endpoints. 1 / 5 / 10 credit ladder.
- GET /v1/app_store/app-search
- GET /v1/app_store/search-suggestions
- GET /v1/app_store/app-info
- GET /v1/app_store/app-reviews
- GET /v1/app_store/app-list
- GET /v1/app_store/app-listings-search
- GET /v1/app_store/categories
- GET /v1/app_store/locations
- GET /v1/app_store/languages
What Apple App Store endpoints does SocialCrawl ship?
Nine live read endpoints for Apple App Store. Search, suggestions, app info, reviews, charts, listings DB search, categories, locations, and languages. Data API only.
Search suggestions
1 credit/v1/app_store/search-suggestionsAutocomplete suggestions for a partial query. Standard tier (1 credit).
query, country, language
App details
5 credits/v1/app_store/app-infoFull Apple App Store listing for an app_id. Title, developer, ratings, description, media. Advanced tier (5 credits).
app_id, country, language
App reviews
5 credits/v1/app_store/app-reviewsUser reviews for an app_id. Rating, text, author, sort and depth controls. Advanced tier (5 credits).
app_id, country, language, depth, sort_by, rating
Store chart
5 credits/v1/app_store/app-listChart or collection listing (top free, category tops, and related collections). Advanced tier (5 credits).
app_collection, app_category, country, language, depth
Listings database search
10 credits/v1/app_store/app-listings-searchPaginated search over the listings database by title (and optional description/filters). Premium tier (10 credits).
title, description, limit, offset, filters, country, language
Categories
1 credit/v1/app_store/categoriesSupported app categories for charts and filters. Standard tier (1 credit).
(none)
Storefront locations
1 credit/v1/app_store/locationsSupported storefront locations/countries. Standard tier (1 credit).
(none)
Languages
1 credit/v1/app_store/languagesSupported languages for storefront reads. Standard tier (1 credit).
(none)
App Store API9 endpoints supported
View docsReturns Apple App Store apps matching a keyword: title, icon, rating, price or free flag, and store URL for each result.
Use it to find an app's numeric id by keyword; description, screenshots, and developer come from app-info.
5 credits
GET/v1/app_store/app-search?query=photo+editor&country=United+States&depth=100
query · Search keyword (e.g. 'photo editor').
$ curl https://www.socialcrawl.dev/v1/app_store/app-search?query=photo+editor&country=United+States&depth=100 \
-H "x-api-key: sc_YOUR_API_KEY"idle
// Running this live needs your own API key. Hit "Try it" to see an example responseHow the Apple App Store API works
Apple App Store is a normal SocialCrawl data surface. You call GET /v1/app_store/… with an API key, spend credits on live misses, and get a single JSON envelope back.
Authenticate every call
Send your key in the x-api-key header. No Apple App Store OAuth app for public reads. The same key works across SocialCrawl platforms.
GET with query params
All Apple App Store routes are GET. Pass query, app_id, app_collection, title, country, language, depth, sort_by as query strings. We validate formats before charging.
Pay in credits, not seats
Reference and suggestions cost 1 credit. App search, info, reviews, and charts cost 5. Listings database search costs 10. Cache hits cost 0.
Read one JSON envelope
Every response is the same shape: success, data, credits_used, credits_remaining, request_id, cached. Lists also carry pagination when the route pages.
The usual integration chain
Most products discover entities first, then deepen detail and reviews only when needed.
01Search
GET /v1/app_store/app-search?query=…AppList with app_id values
Resolve app_id before info and reviews.
02Info
GET /v1/app_store/app-info?app_id=…Full App listing record
Search cards are not a full store page.
03Reviews
GET /v1/app_store/app-reviews?app_id=…ReviewList with sort and depth
User language for ASO and product.
04Charts
GET /v1/app_store/app-list?app_collection=…AppList for a collection/category chart
Rank tracking without a keyword.
request
GET /v1/app_store/app-search?query=photo+editor&country=United+States&depth=30
Host: www.socialcrawl.dev
x-api-key: sc_your_api_key_here
GET /v1/app_store/app-info?app_id=324684580&country=United+States
GET /v1/app_store/app-reviews?app_id=324684580&depth=50&sort_by=most_recentresponse envelope
{
"success": true,
"data": {
"app": {
"id": "324684580",
"title": "Example app",
"developer": "Example Inc",
"rating": 4.6,
"url": "https://example.store/app/324684580"
}
},
"credits_used": 5,
"credits_remaining": 9995,
"request_id": "req_…",
"cached": false
}What lands in data
Field names match the rest of SocialCrawl where archetypes align. Parse once, reuse across platforms.
Appapp-info
id, title, developer, rating, description, media, url
AppListapp-search, app-list, app-listings-search
items[] with app_id, title, developer, rating
ReviewListapp-reviews
items[] with rating, text, author, published_at
Reference / SearchResultcategories, locations, languages, search-suggestions
taxonomy rows, locale lists, or suggestion strings
Inside the gateway
Same request lifecycle as every other /v1 platform endpoint. Apple App Store is not a sidecar.
- 01
Edge receives the call
Next.js catch-all routes into the Hono social API. We mint a request_id, authenticate the key, then enforce rate limit (600/min) and concurrency (50 in flight per key).
- 02
Validate, then debit
Registry lookup finds app_store/app-search (or app-info, app-reviews, app-list). Required params and format checks run first. Invalid input returns 400 with no charge. Valid calls debit the tier cost atomically before upstream work.
- 03
Cache or fetch
A deterministic cache key is built from platform + resource + params. Hit: return immediately, credits_used = 0. Miss: Apple App Store store data upstreams run behind the unified envelope. Retries on 5xx/network with a circuit breaker if the source is unhealthy.
- 04
Normalize and return
Upstream JSON is mapped to commerce archetypes (Product, ProductList, ReviewList, SellerList, App, PlaceList as applicable), validated against the canonical Zod schema, then wrapped in the success envelope and logged for billing audit.
Billing rules that matter in production
- categories / locations / languages / suggestions: 1 credit
- app-search / app-info / app-reviews / app-list: 5 credits
- app-listings-search: 10 credits
- Cache hit: 0 credits
- Empty / hard fail: auto-refund
- Bad params: 400, never charged
- No credits: 402, never charged
- app_id deepens info and reviews
- No install, purchase, or developer console writes
How we get the data
Apple App Store is public read data. We normalize it into the SocialCrawl schema so your code does not learn a second vendor SDK.
What Apple App Store is for this API
Public store listings, charts, suggestions, and user reviews. Read-only.
How SocialCrawl reaches it
Apple App Store store data upstreams behind the unified /v1 envelope.
What leaves our edge
App, AppList, ReviewList, and reference analytics shapes.
What we do not ship live
No install attribution, IAP purchase, or developer console writes.
field map sketch
store listing→ app.*title, developer, rating, media
user reviews→ ReviewListsort_by, depth, rating filter
charts / listings DB→ AppListcollections, categories, premium DB search
What this API is used for
The jobs this API is most often used for.
9active Apple App Store endpoints in the registry
1 / 5 / 10credit ladder for reference, app reads, listings search
ASO research and app review monitoring
Callers concentrate on search or taxonomy, then deepen detail and reviews for shortlisted entities. Full Apple App Store surface under one key: charts, search, info, reviews, and premium listings search with a clear 1/5/10 credit ladder.
Live misses are typically a few seconds. Some routes can take longer on cold cache.
What people build with the Apple App Store API
The jobs Apple App Store data is most often used for. Each one is a full recipe with the endpoint chain and pricing.
Use case examples
Common ways teams put this data to work, and the stack each one tends to run.
ASO teams
Python, sheetsapp-search and app-list for keyword and chart tracking.
Product research
Node, notebooksapp-info plus app-reviews for competitor language.
Catalog pipelines
Go, workersapp-listings-search for bulk title discovery, then app-info.
Call it in two lines
Reference routes are 1 credit. Core app reads are 5. Listings DB search is 10. Cache hits are free.
curl "https://www.socialcrawl.dev/v1/app_store/app-search?query=photo+editor&country=United+States&depth=30" \
-H "x-api-key: sc_your_api_key_here"curl "https://www.socialcrawl.dev/v1/app_store/app-info?app_id=324684580&country=United+States" \
-H "x-api-key: sc_your_api_key_here"Same key as the rest of the catalog
Endpoints
What data does the App Store API return?
Every endpoint returns structured JSON in a unified envelope. Computed fields such as engagement rate and content category are included only where the endpoint supports them and the required source inputs are present.
App SearchSearch Apple App Store apps by keywordSearch SuggestionsGet Apple App Store search suggestionsApp InfoGet full Apple App Store app detailsApp ReviewsGet Apple App Store reviews for an appApp ListGet an Apple App Store chartApp Listings SearchSearch the Apple App Store listings database (paginated)CategoriesList Apple App Store app categoriesLocationsList supported Apple App Store storefront locationsLanguagesList supported Apple App Store languages
Comparison
How does SocialCrawl compare to iTunes Search API + DIY for App Store data?
Same App Store data, two very different paths. Auth, rate limits, schema, and cost, side by side.
| Feature | SocialCrawl | iTunes Search API + DIY |
|---|---|---|
| Authentication | One x-api-key header shared across 65 platforms | None for iTunes Search, but reviews need RSS feeds or scraping on top |
| Setup | One GET request covers search, detail, reviews, and charts | iTunes Search handles lookup well, but reviews and charts need extra DIY plumbing |
| Rate limits | Flat credit pricing with upstream handling | iTunes Search is throttled to roughly 20 calls per minute with no paid upgrade path |
| Response schema | Canonical App schema shared with Google Play | iTunes JSON differs from review RSS, which differs from chart feeds |
| Pricing | 5 credits per app call, 10 for the listings database; 100 free credits | Free, if you build and maintain the review and chart layers yourself |
| Data coverage | Search, detail, reviews, charts, listings, and reference data in one API | Lookup and search only: reviews, charts, and listings are not included |
Authentication
SocialCrawl
One x-api-key header shared across 65 platforms
iTunes Search API + DIY
None for iTunes Search, but reviews need RSS feeds or scraping on top
Setup
SocialCrawl
One GET request covers search, detail, reviews, and charts
iTunes Search API + DIY
iTunes Search handles lookup well, but reviews and charts need extra DIY plumbing
Rate limits
SocialCrawl
Flat credit pricing with upstream handling
iTunes Search API + DIY
iTunes Search is throttled to roughly 20 calls per minute with no paid upgrade path
Response schema
SocialCrawl
Canonical App schema shared with Google Play
iTunes Search API + DIY
iTunes JSON differs from review RSS, which differs from chart feeds
Pricing
SocialCrawl
5 credits per app call, 10 for the listings database; 100 free credits
iTunes Search API + DIY
Free, if you build and maintain the review and chart layers yourself
Data coverage
SocialCrawl
Search, detail, reviews, charts, listings, and reference data in one API
iTunes Search API + DIY
Lookup and search only: reviews, charts, and listings are not included
FAQ
Have a question? We got answers
Find answers to frequently asked questions about SocialCrawl's API, pricing, and capabilities.
Contact usDoes the Apple App Store have an API for app data?
Apple's own App Store Connect API is scoped to apps you publish, but SocialCrawl's App Store API reads any public iOS listing. 9 endpoints cover app search, full app detail, reviews, store charts, a paginated listings database, and category, location, and language references.
What can the SocialCrawl App Store API do?
It searches the Apple App Store by keyword, returns full detail for any numeric app id, pulls user reviews with rating and title, ranks store charts (top free, paid, grossing for iPhone and iPad), queries a paginated listings database, and lists supported categories, locations, and languages.
How do I reference an app in the App Store API?
Apple apps are addressed by a numeric app id, like 324684580 for Spotify, not a package name. Run app-search or app-listings-search to find ids by keyword, then pass app_id to app-info or app-reviews for the detail you need.
How much does the App Store API cost?
App search, info, reviews, and charts run on the advanced tier at 5 credits each; the listings database is premium at 10 credits; categories, locations, and languages are 1 credit. New accounts get 100 free credits and empty lookups are refunded.
Does it use the same schema as Google Play and other stores?
Yes. Apple App Store apps come back in one canonical App schema shared with Google Play, and reviews use the same Review shape as Amazon and Trustpilot, so one parser handles every store you pull from. Apple-only fields like age advisories and supported languages fill in; install counts stay null.
What is the best App Store scraper API?
SocialCrawl's App Store API covers iOS app search, full detail by numeric app id, user reviews, iPhone and iPad top charts, and a paginated listings database across 9 endpoints, all in the App schema shared with Google Play. Core calls cost 5 credits, and signup includes 100 free credits, no card.
Is there an App Store data API for reading public iOS apps?
Yes. SocialCrawl is an App Store data API that reads any public iOS listing without app review. Apple's App Store Connect API is built for managing apps you publish yourself, so it cannot pull arbitrary public apps; SocialCrawl covers that gap with keyword app search, detail by numeric app id, user reviews, iPhone and iPad charts, and a paginated listings database across 9 endpoints, all in the App schema shared with Google Play.
Is scraping App Store data legal?
SocialCrawl returns publicly available App Store data and does not access private or login-gated content. Whether scraping fits your project depends on your use case and jurisdiction. You are responsible for complying with App Store's terms of service and applicable data-protection laws such as GDPR and CCPA. This is general information, not legal advice.
App Store scraping API vs the official App Store API: what's the difference?
With SocialCrawl there is no app review or approval queue. Sign up and call App Store endpoints immediately with a single x-api-key. Responses share one unified schema with every other SocialCrawl platform, and credit-based pricing replaces per-platform quotas. Official APIs are still the right choice for posting and other write actions: SocialCrawl is read-only data.
Ask AI about SocialCrawl