<!--
{
  "availability" : [
    "Search Ads: 5.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "Apple_Ads",
  "identifier" : "/documentation/apple_ads/Find-Ads",
  "metadataVersion" : "0.1.0",
  "role" : "Web Service Endpoint",
  "symbol" : {
    "kind" : "Web Service Endpoint",
    "modules" : [
      "Apple Ads"
    ],
    "preciseIdentifier" : "rest:apple_ads:post:v5-campaigns-{}-ads-find"
  },
  "title" : "Find Ads"
}
-->

# Find Ads

Finds ads within a campaign by selector criteria.

## Discussion

Use this endpoint to find `ads` within campaigns using a [`Selector`](/documentation/apple_ads/Selector) [`Condition`](/documentation/apple_ads/Condition) to filter results. If you don’t specify selector conditions, all [`Ad`](/documentation/apple_ads/Ad) objects return in the response. See the [`Ad`](/documentation/apple_ads/Ad) object for parameter descriptions and selector condition operators.

### Payload example: Find ads

**Request:**

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

{
  "conditions": [
    {
      "field": "creativeType",
      "operator": "EQUALS",
      "values": [
        "CUSTOM_PRODUCT_PAGE"
      ]
    },
    {
      "field": "status",
      "operator": "EQUALS",
      "values": [
        "PAUSED"
      ]
    }
  ],
  "fields": null,
  "orderBy": [
    {
      "field": "creativeType",
      "sortOrder": "ASCENDING"
    }
  ],
  "pagination": {
    "limit": 20,
    "offset": 0
  }
}
```

**Response:**

```json
{
  "data": [
    {
      "id": 573408745,
      "orgId": 39872140,
      "campaignId": 570798765,
      "adGroupId": 440797654,
      "creativeId": 94895512,
      "name": "Trip Trek custom product page variation",
      "creativeType": "CUSTOM_PRODUCT_PAGE",
      "status": "PAUSED",
      "servingStatus": "NOT_RUNNING",
      "servingStateReasons": [
        "PAUSED_BY_USER"
      ],
      "deleted": false,
      "creationTime": "2024-10-08T00:03:47.889Z",
      "modificationTime": "2024-10-09T00:03:47.889Z"
    }
  ],
  "pagination": {
    "totalResults": 1,
    "startIndex": 1,
    "itemsPerPage": 10
  }
}
```

---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)