Skip to content

Search App Store apps

POST/v1/tools/app-store.search.apps/callsNeeds an API key

Returns the App Store apps that match a search, in ranked order, with developer, rating and price. Use it to see which apps rank for a query.

Tool app-store.search.apps on Apple App Store. Contract version 1, released 2026-10-27.

Over REST, send the input in the body. Over MCP, pass the same input to call_tool.

Both return the full response: the call's ID, status and cost, with this tool's result in output.

Input

querystringRequired

What to search for, such as an app's name or a kind of app.

1 to 2048 characters.

countrystring· default us

Two-letter ISO 3166-1 country code of the App Store storefront. Case-insensitive.

One of the 249 values of the countries list: ISO 3166-1 alpha-2 country codes, lowercase.

devicestring· default mobile

Which apps to search: mobile for iPhone, tablet for iPad, desktop for Mac.

desktop
mobile
tablet

Output

A successful call returns these blocks in its output. A field not marked required can be null.

results

A list of rows. Always present, possibly empty.

positioninteger

Rank among the results, starting at 1.

product_idstringRequired

Apple's numeric ID of the app. Send as product_id to app-store.product or app-store.reviews.

titlestringRequired
urlstring

Address of the app's page on the App Store.

descriptionstring
image_urlstring

Address of the app's icon.

developer_namestring
ratingnumber

Average rating, out of 5.

review_countinteger

Number of ratings the average is from.

categorystring

The app's primary category, as the store names it, such as "Education".

content_ratingstring

Age rating as the store shows it, such as "4+".

pricestring

The price as the store shows it, with its currency symbol, such as "$4.99". Not parsed.

price_amountnumber

The price as a number, in currency. 0 for a free app.

currencystring

Three-letter ISO 4217 currency code of price_amount.

versionstring

The app's current version, such as "7.142.0".