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

# Find Ad Groups (org-level)

Fetches ad groups within an organization.

## Discussion

Use this endpoint to find ad groups within your organization. Use a [`Selector`](/documentation/apple_ads/Selector) [`Condition`](/documentation/apple_ads/Condition) to narrow results. If you don’t specify selector conditions, all of your ad groups return in the API response. See the [`AdGroup`](/documentation/apple_ads/AdGroup) object for field descriptions and selector condition operators.

### Payload example: Find ad groups (org-level)

**Request:**

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

{
  "fields": null,
  "conditions": [
    {
      "field": "pricingModel",
      "operator": "EQUALS",
      "values": [
        "CPC"
      ]
    }
  ],
  "orderBy": [
    {
      "field": "id",
      "sortOrder": "ASCENDING"
    }
  ],
  "pagination": {
    "offset": 0,
    "limit": 20
  }
}
```

**Response:**

```json
{
  "data": [
    {
      "id": 542370764,
      "campaignId": 56543219,
      "name": "Trip Trek ad group 5",
      "cpaGoal": null,
      "paymentModel": "PAYG",
      "startTime": "2024-10-20T20:37:21.146Z",
      "endTime": "2024-10-20T20:37:21.146Z",
      "automatedKeywordsOptIn": true,
      "defaultBidAmount": {
        "amount": "1",
        "currency": "USD"
      },
      "pricingModel": "CPC",
      "targetingDimensions": {
        "age": {
          "included": [
            {
              "minAge": 18,
              "maxAge": 55
            }
          ]
        },
        "gender": {
          "included": [
            "F"
          ]
        },
        "country": {
          "included": [
            "US"
          ]
        },
        "adminArea": {
          "included": [
            "CA"
          ]
        },
        "locality": {
          "included": [
            "Cupertino"
          ]
        },
        "deviceClass": {
          "included": [
            "IPHONE",
            "IPAD"
          ]
        },
        "daypart": {
          "userTime": {
            "included": [
              0
            ]
          }
        },
        "appDownloaders": {
          "included": [
            "654327167"
          ],
          "excluded": [
            "654325422"
          ]
        },
        "appCategories": {
          "included": [
            100
          ],
          "excluded": [
            100
          ]
        }
      },
      "orgId": 40669876,
      "modificationTime": "2024-10-20T20:37:21.146Z",
      "status": "ENABLED",
      "servingStatus": "RUNNING",
      "servingStateReasons": [
        "null"
      ],
      "displayStatus": "RUNNING",
      "deleted": false
    }
  ],
  "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)