Search for Apps
Search the App Store for apps matching the supplied criteria and return app details.
URL
GET https://api.ads.apple.com/v1/search/appsQuery Parameters
| Name | Type | Description |
|---|---|---|
query Optional | string | Free-text search matched against app name and developer name. Must contain at least one alphanumeric character and a minimum of 3 characters (2 for CJK languages). |
returnOwnedApps Optional | boolean | Flag that returns apps owned by the caller’s organization when set to |
cpids Optional | string | Comma-separated list of iTunes content provider identifiers. Scopes the search to apps owned by those providers. |
storeFronts Optional | [string] | One or more App Store country or region codes (ISO 3166-1 alpha-2). Repeat the parameter for multiple values. All values must be enabled App Store countries or regions, or the call returns |
offset Optional | int32 | Pagination offset for results. Defaults to |
limit Optional | int32 | Maximum number of results to return. Defaults to |
Header Parameters
| Name | Type | Description |
|---|---|---|
X-Ap-Context Required | string |
Response Codes
| Status | Reason | Type | Description |
|---|---|---|---|
| 200 | OK Content-Type: application/json | AppsSearchResponse | |
| 400 | Bad Request Content-Type: application/json | Error | |
| 401 | Unauthorized Content-Type: application/json | Error | |
| 403 | Forbidden Content-Type: application/json | Error | |
| 404 | Not Found Content-Type: application/json | Error | |
| 429 | Too Many Requests Content-Type: application/json | Error | |
| 500 | Internal Server Error Content-Type: application/json | Error |
Query Parameters
Discussion
This endpoint searches the App Store for apps by name, content provider, or returns apps owned by the caller’s organization. It’s useful for discovering apps to target or advertise before building campaigns.
You must supply at least one of query, cpids, or returnOwnedApps=true. The API rejects calls that supply none of these with INVALID_INPUT.
The returned adamId is the primary identifier used in campaign promotedObject and creative destination fields.