Find Ads
Finds ads within a campaign by selector criteria.
URL
POST https://api.searchads.apple.com/api/v5/campaigns/{campaignId}/ads/findPath Parameters
| Name | Type | Description |
|---|---|---|
campaignId Required | int64 | The unique identifier for the campaign. |
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 |
| 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. |
Discussion
Use this endpoint to find ads within campaigns using a Selector Condition to filter 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
HTTP Body
The request body that includes the selector Condition. Selector objects define what data the API returns when fetching resources.