Find Ads (org-level)

Fetches ads within an organization by selector criteria.

URL

POST https://api.searchads.apple.com/api/v5/ads/find

Response Codes

Status	Reason	Type	Description
200	OK Content-Type: application/json	`AdListResponse`	If the call succeeds, the API returns the AdListResponse 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.
404	Not Found Content-Type: application/json	`ApiErrorResponse`	The API can’t locate 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

Apple Ads Campaign Management API 4

Discussion

Use this endpoint to find ads within your organization using a Selector Condition to narrow results. If you don’t specify selector conditions, all Ad objects return in the response. See the Ad object for parameter descriptions and selector condition operators.

Payload example: Find ads (org-level)

HTTP Body

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