---
title: Find Ads
framework: Apple Ads
role: symbol
role_heading: Web Service Endpoint
platforms: [search ads 5.0+]
path: apple_ads/find-ads
---

# Find Ads

Finds ads within a campaign by selector criteria.

## URL

POST https://api.searchads.apple.com/api/v5/campaigns/{campaignId}/ads/find

## Path Parameters

campaignId: The unique identifier for the campaign.

## Response Codes

200 OK: 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: An invalid query or missing required parameters. 401 Unauthorized: An unauthenticated call fails to get the requested response. 403 Forbidden: Insufficient rights to the resource. 404 Not Found: The API can’t locate the resource. 429 : The API calls exceed rate-limit thresholds. See the Rate Limits subsection of Calling the Apple Ads API. 500 Internal Server Error: The Apple Ads server is temporarily down or unreachable. The request may be valid, but you need to retry it later.

## Discussion

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.

## See Also

### Ad Endpoints

- [Create an Ad](apple_ads/create-an-ad.md)
- [Find Ads (org-level)](apple_ads/find-ads-(org-level).md)
- [Get an Ad](apple_ads/get-an-ad.md)
- [Get All Ads](apple_ads/get-all-ads.md)
- [Update an Ad](apple_ads/update-an-ad.md)
- [Delete an Ad](apple_ads/delete-an-ad.md)