App stores

Apple App Store Search API

Apple App Store Search API. Search apps by keyword, storefront country, and category and get titles, developers, ratings, and IDs as JSON.

Search Apple App Store apps, optionally by developer name, genre, or explicit-content setting. Filter and paginate Apple’s returned inventory of up to 200 apps. Continuations bind the filters and ordered inventory; source ranking changes end pagination.

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. ca, ca-es, cs, cs-cz, da, da-dk, de, de-ch, de-de, el, el-gr, en, en-au, en-ca, en-gb, en-us, es, es-es, es-mx, fi, fi-fi, fr, fr-ca, fr-fr, hi, hi-in, hr, hr-hr, hu, hu-hu, id, id-id, it, it-it, ja, ja-jp, ko, ko-kr, ms, ms-my, nl, nl-nl, no, no-no, pl, pl-pl, pt, pt-br, pt-pt, ro, ro-ro, ru, ru-ru, sk, sk-sk, sv, sv-se, th, th-th, tr, tr-tr, uk, uk-ua, vi, vi-vi, zh, zh-cn, zh-hk, zh-tw
`category`	A category identifier supported by this operation. software, iPadSoftware, macSoftware
`disallow_explicit`	Exclude explicit apps using the native explicit-content control.
`property`	Match the query against developer names within Apple’s returned search inventory. developer
`category_id`	Keep apps with this native genre ID within Apple’s returned search inventory.
`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.

authorauthorsbundle_idcategorycategory_idcontent_ratingcurrencydescriptiondeveloperdeveloper_iddeveloper_urldeveloper_websitedurationduration_minutesfreegenresidinformationinstallsipad_screenshotsisbnlanguagesminimum_installsminimum_os_versionnameoperating_systempagespositionpriceprice_textpublishedpublisherrankratingrating_countrelease_notesreleasedscreenshotssummarysupported_devicesthumbnailtitletypeupdatedurlversionversion_text

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.

SDKs and guides

The official SDKs cover this endpoint with typed parameters, automatic retries, and pagination helpers.

Python SDK: pip install prismcrawl
Node.js SDK: npm install prismcrawl