Search Apps Endpoints
Browse the endpoints for searching apps and retrieving app details.
Overview
Use the Search Apps API to query localized app metadata, find the adamId that becomes the promotedObjectId on your campaign, and verify availableStorefronts before setting campaign target App Store countries or regions.
You can only create campaigns for apps that you own in your ad account. Searching the App Store catalog returns metadata for any public app, but the adamId you use as promotedObjectId must belong to an app you own. To search only the apps your organization owns, use the returnOwnedApps parameter on Search for Apps.
Confirm an app is eligible to advertise with App Eligibility Endpoints before building a campaign around it, and use Product Pages Endpoints to discover its product pages for a creative once it’s eligible.
Explore the Available Endpoints
The Search Apps API provides three endpoints for finding, validating, and describing apps:
Method | Path | Description |
|---|---|---|
|
| Searches the App Store for apps by name, content provider, or returns apps owned by your organization. See Searches For A List Of Apps. |
|
| Retrieves details for a single app by its Adam ID. See Get App Details By Adam Id. |
|
| Returns the languages supported for app advertising in each country or region. See Query Supported App Languages. |
To retrieve the default product page’s localized metadata for an Adam ID, see Query App Locale Details under Product Pages Endpoints.
Review the Fields for App Search Results
Each app returned by the search endpoint includes an AppInfo object with the following fields:
Field | Type | Description |
|---|---|---|
| integer | The app’s Adam ID. Use as |
| string | The application display name as it appears on the App Store. |
| string | The developer or company name. |
| array[string] | Country or region codes where the app is available. |
Review the Fields for a Single App’s Details
Retrieving a single app by Adam ID returns an AppDetails object with the following fields:
Field | Type | Description |
|---|---|---|
| string | The app’s Adam ID. Use as |
| string | The application display name as it appears on the App Store. |
| string | The developer or company name associated with the app in App Store Connect. |
| string | The primary language of the app. |
| string | The primary App Store genre category. |
| string | The secondary App Store genre category, if assigned. |
| array[string] | Supported device classes: |
| string (URI) | URL of the app’s icon image. |
| boolean | Whether the app is currently available as a pre-order. |
| array[string] | ISO 3166-1 alpha-2 country codes where the app is available. Use to validate that a campaign’s |