App Store Search Suggestions
DeprecatedPricing
from $3.99 / 1,000 results
App Store Search Suggestions
DeprecatedGet real-time App Store search suggestions from Apple's autocomplete API. Perfect for discovering in-demand apps and keywords.
Pricing
from $3.99 / 1,000 results
Rating
0.0
(0)
Developer
Coding Frontned
Maintained by CommunityActor stats
0
Bookmarked
2
Total users
0
Monthly active users
a month ago
Last modified
Categories
Features
Share
What does App Store Search Suggestions do?
App Store Search Suggestions is scoped to Apple's public autocomplete hints endpoint. It accepts search phrases and a storefront country, then stores the suggestion text and its query context when Apple makes that route available. It does not return app listings, publishers, ratings, downloads, or app detail pages. See the Apple App Store.
Apple's current public robots policy disallows the legacy autocomplete route. A fresh check on October 14, 2026 confirmed that restriction. A modern suggestions route referenced by Apple's public site also required authentication when checked. The verified default local run therefore saved no suggestions and finished FAILED. Autocomplete collection is currently unavailable.
Why use App Store Search Suggestions?
When Apple's policy permits the hints route, the Actor can collect a bounded set of query suggestions for keyword research, localization comparisons, and search-term seed lists. Apify provides scheduling, run history, API access, dataset exports, and integrations for permitted runs. Results retain the phrase and storefront that produced them, so suggestions from different searches remain distinguishable.
The current robots restriction prevents suggestions from being collected. Changing the query, country, limit, or proxy route cannot override that rule.
What data can App Store Search Suggestions extract?
Each normal dataset item represents one source suggestion for one input phrase.
| Field | Type | Required | Description |
|---|---|---|---|
suggestion | String | Yes | Public suggestion text returned by Apple. |
query | String | Yes | Input phrase that produced the suggestion. |
country | String | Yes | Apple storefront country code used for the request. |
suggestionPosition | Integer | Yes | Position in Apple's original hint list for the query, starting at 1. Omitted malformed or duplicate hints can leave gaps. |
searchUrl | String | No | Valid Apple search URL supplied with the suggestion; omitted when unavailable. |
No diagnostic or placeholder rows are written to the dataset. The run summary is a separate key-value-store record.
How to scrape Apple App Store search suggestions
- Open the Actor's Input tab and enter one or more search phrases.
- Choose an App Store country and set the maximum suggestions per phrase.
- Optionally adjust request pacing, timeout, response size, or the native proxy editor settings.
- Start the run, then inspect the Dataset and the
OUTPUT_SUMMARYitem in the Key-value store.
Under the current robots policy, a run that cannot save a real suggestion finishes with status FAILED, an empty dataset, and a separate summary with itemsStored set to 0.
How much will it cost to scrape Apple App Store search suggestions?
Current Actor pricing is $0.00399 per stored dataset item plus $0.001 per one-time start event per GB of allocated memory, with a minimum of one start event per run. This start event is charged once for the run; it is not a per-minute memory charge. Apify platform usage and any selected proxy service are billed separately under their applicable account pricing. Check the run details and your current Apify pricing before starting a run.
More queries can increase the number of requests if the route is available. The response-size cap, per-request timeout, and delay bound the work. Proxy routing is optional and may have separate charges; it does not change Apple's access policy.
Input
All inputs are optional. If queries is omitted, the Actor uses photo editor, fitness tracker, and game. It accepts at most 100 phrases of at most 200 raw characters each. Surrounding whitespace is trimmed, blank phrases are removed, and duplicate phrases are removed case-insensitively while preserving the first spelling. At least one non-blank phrase must remain.
| Field | Type | Required? | Default | Bounds and behavior |
|---|---|---|---|---|
queries | Array of strings | Optional | photo editor, fitness tracker, game | Up to 100 phrases; each is at most 200 characters. Blank and case-insensitive duplicates are removed. |
country | String | Optional | us | One of us, gb, au, ca, fr, de, it, es, jp, cn, in, br, ru, mx, kr, nl, se, no, dk, fi, pl, hk, sg, ar, tr, id, th, my, ph, vn, ae, or sa. The request country is normalized to lowercase. |
limit | Integer | Optional | 30 | Suggestions requested per phrase, from 1 to 30. |
requestDelayMs | Integer | Optional | 200 | Minimum delay between requests to the same host, from 0 to 5,000 milliseconds. Apple's robots crawl-delay can require a longer wait. |
timeoutSecs | Integer | Optional | 30 | Timeout per HTTP request, from 5 to 120 seconds. |
maxResponseBytes | Integer | Optional | 1000000 | Maximum autocomplete response body size, from 1,000 to 15,000,000 bytes. The robots policy response has a separate fixed 512 KB cap. Larger autocomplete bodies fail the request. |
proxyConfiguration | Object | Optional | {"useApifyProxy":false} | Native Apify proxy editor shape. Direct routing is the default. See the proxy rules below. |
The proxy editor accepts only its native keys: useApifyProxy (boolean), apifyProxyGroups (up to 10 group names), apifyProxyCountry (two-letter country code), and proxyUrls (up to 20 absolute HTTP, HTTPS, or SOCKS5 URLs, each at most 2,048 characters). Group names and proxy country codes are normalized to uppercase. Select Apify Proxy explicitly with useApifyProxy: true before supplying groups or a country. Custom proxyUrls cannot be combined with Apify groups or country. Empty proxy arrays are treated as omitted. The Actor does not log proxy URLs or credentials.
Proxy options
| Field | Type | Required? | Meaning |
|---|---|---|---|
useApifyProxy | Boolean | Optional | Defaults to false. Set to true to use Apify Proxy. |
apifyProxyGroups | Array of strings | Optional | Up to 10 groups. Requires Apify Proxy to be enabled. |
apifyProxyCountry | String | Optional | Two-letter proxy country. Requires Apify Proxy to be enabled. |
proxyUrls | Array of strings | Optional | Up to 20 custom HTTP, HTTPS, or SOCKS5 proxy URLs, each at most 2,048 characters. Requires your working proxy URLs and cannot be combined with Apify Proxy. |
Copyable input examples
Use the default phrases and settings:
{}
Request a small number of suggestions for one phrase:
{"queries": ["photo editor"],"limit": 5}
Compare phrases in the UK storefront:
{"queries": ["running tracker", "budget planner"],"country": "gb","limit": 10}
Set developer controls and keep direct routing:
{"queries": ["meal planner"],"requestDelayMs": 500,"timeoutSecs": 45,"maxResponseBytes": 1000000,"proxyConfiguration": {"useApifyProxy": false}}
Explicitly select Apify Proxy for an account with access to the selected group:
{"queries": ["photo editor"],"proxyConfiguration": {"useApifyProxy": true,"apifyProxyGroups": ["RESIDENTIAL"],"apifyProxyCountry": "US"}}
Custom proxy URL shape (replace the example host with a proxy endpoint you control):
{"queries": ["photo editor"],"proxyConfiguration": {"proxyUrls": ["http://proxy.example:8080"]}}
Output
The dataset is a JSON array of suggestion records. The actual default local run on October 14, 2026 saved no suggestion rows; its complete dataset output is:
[]
The current access restriction prevented source suggestions from being saved. A suggestion item, when available from Apple's permitted endpoint, has the stable fields listed above. searchUrl is optional and is omitted when Apple does not supply a valid Apple search link.
The run summary is stored separately under the key OUTPUT_SUMMARY in the default key-value store. The same local run saved this separate summary value:
{"status": "FAILED","itemsStored": 0,"isPartial": false}
status is SUCCEEDED only when at least one real suggestion row is saved; it is FAILED when no real rows are saved. itemsStored counts completed dataset writes. isPartial is true when a later collection failure or abort stops a run after real rows have been saved. The summary is not a dataset row. You can download the dataset in various formats such as JSON, HTML, CSV, or Excel.
Tips and advanced options
Start with one phrase and a small limit. The limit applies independently to each phrase, while requestDelayMs sets a minimum delay between requests to the same host. Apple's robots crawl-delay can require a longer wait. Failed requests are not retried. The Actor checks Apple's robots policy before requesting the hints endpoint. It follows at most five redirects when each destination remains on the approved Apple host and path, and checks the destination against robots policy before requesting it. A block, oversized response, or timeout does not produce a fabricated suggestion.
Use the storefront country to select Apple's search market. The proxy country is separate: apifyProxyCountry selects a proxy location and requires explicit Apify Proxy selection. Custom proxy URLs can be used instead of Apify Proxy groups and country. No proxy choice changes the robots check or guarantees access.
FAQ, support, and responsible use
Why is my dataset empty? Apple's public robots policy disallows the legacy autocomplete endpoint, so the Actor stops before requesting it. A modern API route referenced by Apple's public bundle returned HTTP 401 to an unauthenticated request. The Actor does not bypass authentication. Check this README and the run summary for updated availability.
Can I use the Actor for app ratings or publisher data? No. The product contract covers autocomplete suggestions only. App catalog and app detail fields are not tied to a suggestion in the verified source output.
Where can I get help? Use the Actor's Issues tab and include the run ID, a sanitized input, and the OUTPUT_SUMMARY result. Do not share tokens, proxy credentials, or other secrets.
This Actor is not affiliated with Apple. Follow Apple's terms, robots policy, and rate limits, along with applicable law.