Find App Assets

Fetches app asset metadata by adam ID.

URL

POST https://api.searchads.apple.com/api/v5/apps/{adamId}/assets/find

Path Parameters

Name Type Description

Name	Type	Description
`adamId` Required	int64	Your unique App Store app identifier. Your `adamId` in the resource path needs to match the `adamId` in your campaign. Use Get a Campaign or Get all Campaigns to obtain your `adamId` and correlate it to the correct campaign.

adamId Required

int64

Your unique App Store app identifier.

Your adamId in the resource path needs to match the adamId in your campaign. Use Get a Campaign or Get all Campaigns to obtain your adamId and correlate it to the correct campaign.

Response Codes

Status	Reason	Type	Description
200	OK Content-Type: application/json	`AppAssetListResponse`	If the call succeeds, the API returns the AppAssetListResponse object in the response payload with an HTTP status code of `200(OK)`. If unsuccessful, the HTTP status code indicates the error with details in the error message.
400	Bad Request Content-Type: application/json	`ApiErrorResponse`	An invalid query or missing required parameters.
401	Unauthorized Content-Type: application/json	`ApiErrorResponse`	An unauthenticated call fails to get the requested response.
403	Forbidden Content-Type: application/json	`ApiErrorResponse`	Insufficient rights to the resource.
429	Content-Type: application/json	`ApiErrorResponse`	The API calls exceed rate-limit thresholds. See the Rate Limits subsection of Calling the Apple Ads API.
500	Internal Server Error Content-Type: application/json	`ApiErrorResponse`	The Apple Ads server is temporarily down or unreachable. The request may be valid, but you need to retry it later.

Mentioned in

Discussion

Use this endpoint with Selector to find app asset metadata associated with an adamId. Use your adamId in the resource path. See the AppAsset object for parameter descriptions and selector condition operators.

This endpoint supports default and custom product page ads.

Payload example: Find app assets

HTTP Body

The request body that includes the selector Condition. Selector objects define what data the API returns when fetching resources.