App stores

Apple App Store Search API

Search Apple App Store apps and paginate the source's returned inventory of up to 200 results. Continuation is scoped to the query and fails if the ordered source inventory changes.

Try in the request builder API reference Connect with MCP

Make a request

Use your existing PrismCrawl API key and credit balance. A completed request consumes one credit, including recognized empty or unavailable results and source changes found during a valid continuation. Validation and operational errors remain uncharged. Each completed continuation request is billed separately.

POST /v1/apple/app-store/search

curl 'https://api.prismcrawl.com/v1/apple/app-store/search' \
  --request POST \
  --header 'content-type: application/json' \
  --header 'x-api-key: <PRISMCRAWL_API_KEY>' \
  --data '{
  "country": "us",
  "query": "weather"
}'

Supported parameters

Parameter	Usage
`query`Required	Text to search for on the selected service.
`country`	Two-letter country or storefront code, such as us or gb.
`language`	Provider-supported language code, such as en. en, ja
`category`	A category identifier supported by this operation. software, iPadSoftware, macSoftware
`limit`	Maximum number of items to return. The provider may return fewer.
`device`	Device presentation for the source request. desktop, mobile, tablet
`next_page_token`	Continue within Apple's returned catalog inventory, up to 200 apps per search. Use the same account, query, category, country, language, device, and result limit. The opaque token expires after one hour. Expired tokens are rejected before execution. If Apple's inventory changes during a valid continuation, the completed response costs one credit and marks pagination_reason: stale_cursor; restart the search.
`html`	Return the encoded original response rather than parsed JSON.
`zero_trace`	Do not archive source or parsed response artifacts.

Structured results

Read items from data.content.results. The response also includes the search metadata, pagination state, and any extracted SERP features. Optional fields appear when supplied by the provider.

Pages cover the apps returned by Apple's software catalog, up to 200 per query. Search metadata reports source_result_count and pagination_limit. If Apple's result inventory changes between requests, a completed continuation returns HTTP 200 with pagination_limited: true and pagination_reason: stale_cursor. This response costs one credit; restart the search to obtain a fresh result inventory.

idtitlenameurlpositionthumbnailratingdescriptionsummarydeveloperdeveloper_iddeveloper_websiteauthorauthorsbundle_idcategorycategory_idrating_countpriceprice_textcurrencyfreeinstallsminimum_installscontent_ratingoperating_systemreleasedupdatedversionversion_textrelease_notesscreenshotsminimum_os_versionlanguagessupported_devicespublisherpublishedisbnpagesdurationduration_minutesinformation

Continue with data.content.next_page_token when has_next_page is true. Omit page when using a token and keep the other request parameters unchanged, including the query or ID, country, language, device, result limit, and sort order. Stop when no token is returned. Tokens belong to the same account and expire after one hour. Restart pagination if a token is expired or rejected, including tokens issued before authenticated tokens were introduced. If the source inventory changes after a valid continuation is fetched, a completed HTTP 200 response costs one credit and marks pagination_limited: true with pagination_reason: stale_cursor. Keep any returned results and restart pagination; no continuation token is returned.