100 free credits. No credit card required
App Store App Search API
Scrape App Store App Search data with one API call. Returns a unified AppList of Apple App Store apps matching a keyword: title, icon, developer, category, rating, price/is_free, and store URL on every item, on the same canonical `App` shape used across every app marketplace (`app.store` = "app_store"). `app.rank` is the position of the app in the results (1 is the first). Detail-only fields (description, screenshots, similar apps) are null on search items; fetch /v1/app_store/app-info for the full record. Served from the Apple App Store catalogue: a first, uncached call is task-polled upstream and typically takes 3 to 15s, with a review pull at high `depth` reaching 40s. Set a client timeout of at least 60s.
Last updated October 2026Maintained by the SocialCrawl team
Returns 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.
Searching 69 platforms in parallel
·
TikTok·
Instagram·
YouTube·
Facebook·
X·
LinkedIn·
Reddit·
Threads·
Pinterest·
Twitch·
Truth Social·
Snapchat·
Kick·
Bluesky·
Kwai·
Rumble·
Spotify·
Apple Music·TikTok Shop·
Amazon Shop·
Google Shopping·
Trustpilot·
TripAdvisor·
Yelp·
Linktree·
Komi·
Pillar·
lnk.bio·Facebook Ads·Google Ads·LinkedIn Ads·Google Search·Google News·
Finance·
Polymarket·
Tavily·
Hacker News·
GitHub·
Perplexity·
Naver·
Utility·
Universal Search
TikTok·Instagram·YouTube·Facebook·X·LinkedIn·Reddit·Threads·Pinterest·Twitch·Truth Social·Snapchat·Kick·Bluesky·Kwai·Rumble·Spotify·Apple Music·TikTok Shop·Amazon Shop·Google Shopping·Trustpilot·TripAdvisor·Yelp·Linktree·Komi·Pillar·lnk.bio·Facebook Ads·Google Ads·LinkedIn Ads·Google Search·Google News·Finance·Polymarket·Tavily·Hacker News·GitHub·Perplexity·Naver·Utility·Universal Search·TikTok·Instagram·YouTube·Facebook·X·LinkedIn·Reddit·Threads·Pinterest·Twitch·Truth Social·Snapchat·Kick·Bluesky·Kwai·Rumble·Spotify·Apple Music·TikTok Shop·Amazon Shop·Google Shopping·Trustpilot·TripAdvisor·Yelp·Linktree·Komi·Pillar·lnk.bio·Facebook Ads·Google Ads·LinkedIn Ads·Google Search·Google News·Finance·Polymarket·Tavily·Hacker News·GitHub·Perplexity·Naver·Utility·Universal Search
TikTok·Instagram·YouTube·Facebook·X·LinkedIn·Reddit·Threads·Pinterest·Twitch·Truth Social·Snapchat·Kick·Bluesky·Kwai·Rumble·Spotify·Apple Music·TikTok Shop·Amazon Shop·Google Shopping·Trustpilot·TripAdvisor·Yelp·Linktree·Komi·Pillar·lnk.bio·Facebook Ads·Google Ads·LinkedIn Ads·Google Search·Google News·Finance·Polymarket·Tavily·Hacker News·GitHub·Perplexity·Naver·Utility·Universal Search·TikTok·Instagram·YouTube·Facebook·X·LinkedIn·Reddit·Threads·Pinterest·Twitch·Truth Social·Snapchat·Kick·Bluesky·Kwai·Rumble·Spotify·Apple Music·TikTok Shop·Amazon Shop·Google Shopping·Trustpilot·TripAdvisor·Yelp·Linktree·Komi·Pillar·lnk.bio·Facebook Ads·Google Ads·LinkedIn Ads·Google Search·Google News·Finance·Polymarket·Tavily·Hacker News·GitHub·Perplexity·Naver·Utility·Universal Search
TikTok·Instagram·YouTube·Facebook·X·LinkedIn·Reddit·Threads·Pinterest·Twitch·Truth Social·Snapchat·Kick·Bluesky·Kwai·Rumble·Spotify·Apple Music·TikTok Shop·Amazon Shop·Google Shopping·Trustpilot·TripAdvisor·Yelp·Linktree·Komi·Pillar·lnk.bio·Facebook Ads·Google Ads·LinkedIn Ads·Google Search·Google News·Finance·Polymarket·Tavily·Hacker News·GitHub·Perplexity·Naver·Utility·Universal Search·TikTok·Instagram·YouTube·Facebook·X·LinkedIn·Reddit·Threads·Pinterest·Twitch·Truth Social·Snapchat·Kick·Bluesky·Kwai·Rumble·Spotify·Apple Music·TikTok Shop·Amazon Shop·Google Shopping·Trustpilot·TripAdvisor·Yelp·Linktree·Komi·Pillar·lnk.bio·Facebook Ads·Google Ads·LinkedIn Ads·Google Search·Google News·Finance·Polymarket·Tavily·Hacker News·GitHub·Perplexity·Naver·Utility·Universal Search
TikTok·Instagram·YouTube·Facebook·X·LinkedIn·Reddit·Threads·Pinterest·Twitch·Truth Social·Snapchat·Kick·Bluesky·Kwai·Rumble·Spotify·Apple Music·TikTok Shop·Amazon Shop·Google Shopping·Trustpilot·TripAdvisor·Yelp·Linktree·Komi·Pillar·lnk.bio·Facebook Ads·Google Ads·LinkedIn Ads·Google Search·Google News·Finance·Polymarket·Tavily·Hacker News·GitHub·Perplexity·Naver·Utility·Universal SearchApp Store API
What can you do with the App Search API?
The App Search endpoint gives you structured App Store data with computed fields in a single request. No scraping infrastructure to build or maintain.
Example Request
# GET /v1/app_store/app-search: 5 credits per call. Cache hits are free and failed calls are refunded.
# Check the price first for 0 credits: add dry_run=1 to the query. Nothing is fetched or charged.
# --max-time 60: the API's own time limit for this endpoint.
# --retry 3: retries timeouts, 429 and 5xx, honoring Retry-After.
# -o response.json keeps only the final attempt's body.
# One Idempotency-Key per request, reused on every retry, so a retried call is never charged twice.
IDEMPOTENCY_KEY=$(od -An -N16 -tx1 /dev/urandom | tr -d ' \n')
curl -sS --max-time 60 --retry 3 -o response.json \
-H "x-api-key: YOUR_API_KEY" \
-H "Idempotency-Key: $IDEMPOTENCY_KEY" \
"https://www.socialcrawl.dev/v1/app_store/app-search?query=photo+editor&country=United+States&depth=100" && cat response.json# GET /v1/app_store/app-search: 5 credits per call. Cache hits are free and failed calls are refunded.
# Check the price first for 0 credits: add dry_run=1 to the query. Nothing is fetched or charged.
import os
import random
import time
import uuid
import requests
API_KEY = os.environ.get("SOCIALCRAWL_API_KEY", "YOUR_API_KEY")
TIMEOUT_S = 60 # the API's own time limit for this endpoint.
MAX_RETRIES = 3
URL = "https://www.socialcrawl.dev/v1/app_store/app-search"
def backoff(attempt):
# Exponential backoff with jitter: about 1 s, 2 s, then 4 s.
return 2 ** attempt * (0.5 + random.random() / 2)
def socialcrawl(params):
# One Idempotency-Key per request, reused on every retry, so a retried call is never charged twice.
idempotency_key = str(uuid.uuid4())
for attempt in range(MAX_RETRIES + 1):
try:
res = requests.get(
URL,
params=params,
headers={"x-api-key": API_KEY, "Idempotency-Key": idempotency_key},
timeout=TIMEOUT_S,
)
body = res.json()
except (requests.RequestException, ValueError):
# A timeout, a dropped connection or a non-JSON gateway page: retry with the same key.
if attempt == MAX_RETRIES:
raise
time.sleep(backoff(attempt))
continue
if body["success"]:
return body
error = body["error"]
# Branch on error["type"], never on the message text.
if error["type"] == "RESOURCE_NOT_FOUND":
return None # refunded: nothing to read
retry_after = res.headers.get("Retry-After")
# SERVICE_UNAVAILABLE without Retry-After is a withdrawn endpoint: permanent.
permanent = error["type"] == "SERVICE_UNAVAILABLE" and retry_after is None
if not error.get("retryable") or permanent or attempt == MAX_RETRIES:
raise RuntimeError(f"{error['type']}: {error['message']} (request_id {body['request_id']})")
# Retry-After (seconds) wins; otherwise back off.
time.sleep(float(retry_after) if retry_after else backoff(attempt))
params = {
"query": "photo editor",
"country": "United States",
"depth": "100",
}
body = socialcrawl(params)
if body is not None:
print(body["data"])// GET /v1/app_store/app-search: 5 credits per call. Cache hits are free and failed calls are refunded.
// Check the price first for 0 credits: add dry_run=1 to the query. Nothing is fetched or charged.
const API_KEY = process.env.SOCIALCRAWL_API_KEY ?? "YOUR_API_KEY";
const TIMEOUT_MS = 60_000; // the API's own time limit for this endpoint.
const MAX_RETRIES = 3;
type Page = { next_cursor: string | null; has_more: boolean };
type SocialCrawlResponse =
| { success: true; data: any; pagination?: Page; credits_used: number; request_id: string }
| { success: false; error: { type: string; message: string; retryable: boolean }; request_id: string };
const sleep = (ms: number) => new Promise((resolve) => setTimeout(resolve, ms));
// Exponential backoff with jitter: about 1 s, 2 s, then 4 s.
const backoffMs = (attempt: number) => 2 ** attempt * 1000 * (0.5 + Math.random() / 2);
async function socialcrawl(url: URL) {
// One Idempotency-Key per request, reused on every retry, so a retried call is never charged twice.
const idempotencyKey = crypto.randomUUID();
for (let attempt = 0; ; attempt++) {
let res: Response;
let body: SocialCrawlResponse;
try {
res = await fetch(url, {
headers: {
"x-api-key": API_KEY,
"Idempotency-Key": idempotencyKey,
},
signal: AbortSignal.timeout(TIMEOUT_MS),
});
body = (await res.json()) as SocialCrawlResponse;
} catch (error) {
// A timeout, a dropped connection or a non-JSON gateway page: retry with the same key.
if (attempt >= MAX_RETRIES) throw error;
await sleep(backoffMs(attempt));
continue;
}
if (body.success) return body;
// Branch on error.type, never on the message text.
if (body.error.type === "RESOURCE_NOT_FOUND") return null; // refunded: nothing to read
const retryAfter = res.headers.get("Retry-After");
// SERVICE_UNAVAILABLE without Retry-After is a withdrawn endpoint: permanent.
const permanent = body.error.type === "SERVICE_UNAVAILABLE" && retryAfter === null;
if (!body.error.retryable || permanent || attempt >= MAX_RETRIES) {
throw new Error(`${body.error.type}: ${body.error.message} (request_id ${body.request_id})`);
}
// Retry-After (seconds) wins; otherwise back off.
await sleep(retryAfter ? Number(retryAfter) * 1000 : backoffMs(attempt));
}
}
const url = new URL("https://www.socialcrawl.dev/v1/app_store/app-search");
url.searchParams.set("query", "photo editor");
url.searchParams.set("country", "United States");
url.searchParams.set("depth", "100");
const body = await socialcrawl(url);
if (body) console.log(body.data);Parameters worth sending
country=United StatesResults for one country.
Parameters
| Parameter | Required | Description |
|---|---|---|
| query | Yes | Search keyword (e.g. 'photo editor'). |
| country | No | Storefront country as an ISO code ('US'), a full name ('United States'), or a numeric location code ('2840'). Defaults to the US. |
| language | No | Language code (e.g. 'en'). Defaults to 'en'. |
| depth | No | Number of results to retrieve (default 100, rounded up to multiples of 100, max 300). |
Example Response
What does the App Store App Search API return?
Every response follows one unified schema. Here is a real, unmodified response body, so you can see the exact fields you get back before spending a credit.
Example response
{
"success": true,
"platform": "app_store",
"endpoint": "/v1/app_store/app-search",
"data": {
"items": [
{
"app": {
"id": "587366035",
"store": "app_store",
"url": "https://apps.apple.com/us/app/picsart-ai-photo-editor-video/id587366035",
"title": "Picsart AI Photo Editor, Video",
"subtitle": null,
"icon": "https://is1-ssl.mzstatic.com/image/thumb/Purple211/v4/90/74/ad/9074ad22-9ac6-8a59-364c-14ea2ada5608/AppIcon-0-0-1x_U007emarketing-0-8-0-sRGB-85-220.png/512x512bb.jpg",
"description": null,
"developer": {
"id": "587366038",
"name": "PicsArt, Inc.",
"url": "https://apps.apple.com/us/developer/picsart-inc/id587366038?uo=4",
"email": null,
"address": null,
"website": "https://picsart.com"
},
"rating": {
"value": 4.7,
"max": 5,
"count": 1195629
},
"price": {
"current": 0,
"original": null,
"currency": "USD",
"is_free": true,
"displayed": null
},
"reviews_count": 1195629,
"category": "Photo & Video",
"categories": [
"Photo & Video",
"Graphics & Design"
],
"installs": null,
"version": null,
"minimum_os_version": null,
"size": null,
"released_at": "2013-01-02T22:14:40Z",
"updated_at": null,
"update_notes": null,
"image_urls": null,
"ext": {
"appdata": {
"type": "app_store_search_organic",
"rank_group": 1,
"rank_absolute": 1,
"position": "left",
"app_id": "587366035",
"title": "Picsart AI Photo Editor, Video",
"url": "https://apps.apple.com/us/app/picsart-ai-photo-editor-video/id587366035",
"icon": "https://is1-ssl.mzstatic.com/image/thumb/Purple211/v4/90/74/ad/9074ad22-9ac6-8a59-364c-14ea2ada5608/AppIcon-0-0-1x_U007emarketing-0-8-0-sRGB-85-220.png/512x512bb.jpg",
"reviews_count": 1195629,
"rating": {
"rating_type": "Max5",
"value": 4.7,
"votes_count": 1195629,
"rating_max": 5
},
"is_free": true,
"price": {
"current": 0,
"regular": null,
"max_value": null,
"currency": "USD",
"is_price_range": false,
"displayed_price": null
},
"main_category": "Photo & Video",
"categories": [
"Photo & Video",
"Graphics & Design"
],
"released_date": "2013-01-02T22:14:40Z",
"developer": "PicsArt, Inc.",
"developer_id": "587366038",
"developer_url": "https://apps.apple.com/us/developer/picsart-inc/id587366038?uo=4",
"developer_website": "https://picsart.com"
}
}
}
},
{
"app": {
"id": "998411110",
"store": "app_store",
"url": "https://apps.apple.com/us/app/airbrush-face-photo-editor/id998411110",
"title": "Airbrush: Face Photo Editor",
"subtitle": null,
"icon": "https://is1-ssl.mzstatic.com/image/thumb/Purple211/v4/84/13/99/84139961-ba84-c40c-3112-f50348bdfccc/AppIcon-0-0-1x_U007emarketing-0-11-0-85-220.png/512x512bb.jpg",
"description": null,
"developer": {
"id": "1533253001",
"name": "PIXOCIAL TECHNOLOGY (SINGAPORE) PTE. LTD.",
"url": "https://apps.apple.com/us/developer/pixocial-technology-singapore-pte-ltd/id1533253001?uo=4",
"email": null,
"address": null,
"website": "http://appairbrush.com/"
},
"rating": {
"value": 4.8,
"max": 5,
"count": 203135
},
"price": {
"current": 0,
"original": null,
"currency": "USD",
"is_free": true,
"displayed": null
},
"reviews_count": 203135,
"category": "Photo & Video",
"categories": [
"Photo & Video",
"Graphics & Design"
],
"installs": null,
"version": null,
"minimum_os_version": null,
"size": null,
"released_at": "2015-10-08T05:51:37Z",
"updated_at": null,
"update_notes": null,
"image_urls": null,
"ext": {
"appdata": {
"type": "app_store_search_organic",
"rank_group": 2,
"rank_absolute": 2,
"position": "left",
"app_id": "998411110",
"title": "Airbrush: Face Photo Editor",
"url": "https://apps.apple.com/us/app/airbrush-face-photo-editor/id998411110",
"icon": "https://is1-ssl.mzstatic.com/image/thumb/Purple211/v4/84/13/99/84139961-ba84-c40c-3112-f50348bdfccc/AppIcon-0-0-1x_U007emarketing-0-11-0-85-220.png/512x512bb.jpg",
"reviews_count": 203135,
"rating": {
"rating_type": "Max5",
"value": 4.8,
"votes_count": 203135,
"rating_max": 5
},
"is_free": true,
"price": {
"current": 0,
"regular": null,
"max_value": null,
"currency": "USD",
"is_price_range": false,
"displayed_price": null
},
"main_category": "Photo & Video",
"categories": [
"Photo & Video",
"Graphics & Design"
],
"released_date": "2015-10-08T05:51:37Z",
"developer": "PIXOCIAL TECHNOLOGY (SINGAPORE) PTE. LTD.",
"developer_id": "1533253001",
"developer_url": "https://apps.apple.com/us/developer/pixocial-technology-singapore-pte-ltd/id1533253001?uo=4",
"developer_website": "http://appairbrush.com/"
}
}
}
}
],
"total": 96,
"dropped": 0
},
"credits_used": 5,
"request_id": "req_example000000",
"cached": false,
"pagination": {
"next_cursor": null,
"has_more": false,
"page_size": 96
},
"credits_remaining": 9999,
"source": "captured",
"captured_at": "2026-10-02T12:47:45.562Z",
"redacted": true
}Live sample illustrating the unified response shape. Field values reflect the record you query.
API Details
How does the App Store App Search API work?
Send a GET request with your API key and get back clean, structured JSON in our unified schema. Supported computed fields are populated when the source provides the required inputs.
Method
GET
Response
JSON
Developer First
How do you scrape social media data in seconds?
The fastest social media scraping API for developers. Scrape profiles, posts, comments, and analytics from 69 platforms covering 10B+ monthly active users.
One schema, every platform
Query 69 platforms with identical response structures. Write your integration once.
Computed fields, not just scraped
When an endpoint supports these metrics and the source provides the required inputs, the normalized record includes engagement_rate, estimated_reach, content_category, and language. Ready to use.
See your data before you code
Visual Data Explorer. Paste any URL, get rich result cards, sortable tables, CSV export.
import requests
response = requests.get(
'https://www.socialcrawl.dev/v1/tiktok/profile',
params={'handle': 'charlidamelio'},
headers={'x-api-key': 'sc_YOUR_API_KEY'}
)
data = response.json()[ .JSON ]
{
"success": true,
"platform": "tiktok",
"data": {
"author": {
"username": "charlidamelio",
"followers": 152400000
},
"engagement": {
"likes": 12400000000,
"engagement_rate": 0.087
},
"metadata": {
"language": "en",
"content_category": "lifestyle"
}
}
}FAQ
Have a question? We got answers
Find answers to frequently asked questions about SocialCrawl's API, pricing, and capabilities.
Contact usHow do I search the Apple App Store with an API?
Send a GET request to /v1/app_store/app-search with a query parameter (e.g. query=photo editor). The response is a unified AppList: each item has the title, icon, rating, price, and the numeric app id you pass to app-info.
What fields does App Store search return?
Each result includes the numeric app id, title, icon URL, average rating with count, price, a free flag, and store URL, enough to render a results grid or feed app ids into the app-info endpoint. Detail-only fields like description and screenshots are null on search items.
How is app search different from the listings endpoint?
App search returns the Apple App Store's current ranked matches, like the store's own search box. Exact repeat searches may use the 2-minute public cache; cache hits cost 0 credits, and Cache-Control: no-cache requests a billed refresh. The app-listings-search endpoint queries a paginated database by title with filters and a platform-wide total instead.
How much does App Store app search cost?
App search runs on the advanced tier at 5 credits per call, since it fetches a fresh ranked result set from the Apple App Store. New accounts get 100 free credits with no card, and an empty result is refunded automatically.
Can I search the App Store by country or language?
Yes. Optional country and language parameters set the storefront and locale, so you can search the same keyword across regions. Pass the numeric app id from any result into app-info or app-reviews to fetch deeper detail.
Ask AI about SocialCrawl
Ready to scrape App Store App Search data?
Get your API key and start pulling App Store data in under 60 seconds.