App Store Search Suggestions API
Scrape App Store Search Suggestions data with one API call. Returns Apple's App Store search autocomplete ('search hints') for a keyword stem — the same suggestions the store's search box surfaces, ranked by Apple's own priority. The day Apple starts autocompleting a phrase, real demand exists; poll a stem daily and diff to catch rising app keywords early. Each item is `{ term, priority }` where `priority` is the 1-based upstream rank (Apple exposes no numeric score). Returns a list under `items`.
Last updated August 2026Maintained by the SocialCrawl team
Returns the autocomplete search hints the Apple App Store search box suggests for a keyword stem, each with its rank in Apple's own ordering.
Use it for App Store keyword research: poll a stem daily and diff the list to catch rising searches early.
Searching 48 platforms in parallel
What can you do with the Search Suggestions API?
The Search Suggestions endpoint gives you structured App Store data with computed fields in a single request. No scraping infrastructure to build or maintain.
Example Request
curl -H "x-api-key: YOUR_API_KEY" \
"https://www.socialcrawl.dev/v1/app_store/search-suggestions?query=reverse"import requests
response = requests.get(
"https://www.socialcrawl.dev/v1/app_store/search-suggestions",
params={
'query': 'reverse',
},
headers={"x-api-key": "YOUR_API_KEY"},
)
data = response.json()const response = await fetch(
"https://www.socialcrawl.dev/v1/app_store/search-suggestions?query=reverse",
{
headers: { "x-api-key": "YOUR_API_KEY" },
},
);
const data = await response.json();Parameters
| Parameter | Required | Description |
|---|---|---|
| query | Yes | Partial search keyword to autocomplete (e.g. 'reverse'). |
| country | No | ISO 3166-1 alpha-2 storefront country code. Defaults to 'us'. |
What does the App Store Search Suggestions 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": "google",
"endpoint": "/v1/google/search",
"data": {
"items": [
{
"title": "My Top 50 London Restaurants (26 Jan-9 Feb 2025)",
"url": "https://anguscolwell.substack.com/p/my-top-50-london-restaurants-26-jan",
"description": "Feb 9, 2025 · 1) Bouchon Racine, Farringdon. I'm completely obsessed with it, I love it more than anywhere else, it's operating on a level above any other ..."
},
{
"title": "The 38 Best London Restaurants According to Eater's Local Dining ...",
"url": "https://www.eater.com/maps/best-london-restaurants-eater-38",
"description": "The best meals in London, from Michelin fine dining to beloved street food, according to a longtime restaurant editor."
},
{
"title": "LONDON by The MICHELIN Guide",
"url": "https://guide.michelin.com/us/en/travel-guide/london",
"description": "Discover the beloved restaurants and exciting new openings that everyone is talking about: London's bustling pubs, MICHELIN-Starred restaurants that are among ..."
}
],
"dropped": 0
},
"credits_used": 1,
"credits_remaining": 9999,
"request_id": "req-8Kq2ZmR4vT9xLb3P",
"cached": false,
"pagination": {
"next_cursor": "sc.eyJ2IjoyLCJjIjoiMiIsInAiOiJwYWdlIn0",
"has_more": true,
"page_size": 10
}
}Example captured from the Google Search API. Every SocialCrawl endpoint returns this same unified schema, so your App Store Search Suggestions response has the same fields.
How does the App Store Search Suggestions 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
How do you scrape social media data in seconds?
The fastest social media scraping API for developers. Scrape profiles, posts, comments, and analytics from 48 platforms covering 10B+ monthly active users.
One schema, every platform
Query 48 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(){
"success": true,
"platform": "tiktok",
"data": {
"author": {
"username": "charlidamelio",
"followers": 152400000
},
"engagement": {
"likes": 12400000000,
"engagement_rate": 0.087
},
"metadata": {
"language": "en",
"content_category": "lifestyle"
}
}
}Ready to scrape App Store Search Suggestions data?
Get your API key and start pulling App Store data in under 60 seconds.
