Get App Details by Adam ID
Retrieve application details for a specific Adam ID.
URL
GET https://api.ads.apple.com/v1/apps/{adamId}Path Parameters
| Name | Type | Description |
|---|---|---|
adamId Required | int64 |
Header Parameters
| Name | Type | Description |
|---|---|---|
X-Ap-Context Required | string |
Response Codes
| Status | Reason | Type | Description |
|---|---|---|---|
| 200 | OK Content-Type: application/json | AppDetailsResponse | |
| 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 | AppDetailsResponse | |
| 429 | Too Many Requests Content-Type: application/json | Error | |
| 500 | Internal Server Error Content-Type: application/json | Error |
Discussion
This endpoint retrieves the full details of a specific app by its Adam identifier, including its name, genre, and supported device classes.
Obtain the app’s Adam ID from a search or from existing campaign targeting data before calling this endpoint. The endpoint returns a single AppDetails object in the result field, or a null result with an ENTITY_NOT_FOUND error if no app matches the supplied Adam ID.
Use the returned deviceClasses and availableStorefronts values to confirm that an app’s supported devices and countries or regions align with a campaign’s targeting settings before creating an ad group.