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

# Find Ads (org-level)

Fetches ads within an organization by selector criteria.

## Discussion

Use this endpoint to find `ads` within your organization using a [`Selector`](/documentation/apple_ads/Selector) [`Condition`](/documentation/apple_ads/Condition) to narrow 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 (org-level)

**Request:**

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

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

**Response:**

```json
{
  "data": [
    {
      "id": 573408653,
      "orgId": 39872140,
      "campaignId": 570798745,
      "adGroupId": 476797743,
      "creativeId": 94895534,
      "name": "Trip Trek custom product page variation",
      "creativeType": "CUSTOM_PRODUCT_PAGE",
      "status": "ENABLED",
      "servingStatus": "RUNNING",
      "servingStateReasons": null,
      "deleted": false,
      "creationTime": "2024-10-20T20:35:06.227Z",
      "modificationTime": "2024-10-20T20:35:06.227Z"
  }
  ],

    "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)