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

# Find Ad Groups

Fetches ad groups within a campaign.

## Discussion

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

### Payload example: Find ad groups

**Request:**

```http
POST https://api.searchads.apple.com/api/v5/campaigns/<campaignid>/adgroups/find

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

**Response:**

```json
{
  "data": [
    {
      "id": 542370642,
      "campaignId": 56543219,
      "name": "Trip Trek ad group 1",
      "cpaGoal": null,
      "startTime": "2026-04-08T07:00:00.000",
      "endTime": null,
      "automatedKeywordsOptIn": true,
      "defaultBidAmount": {
        "amount": "1",
        "currency": "USD"
      },
      "pricingModel": "CPC",
      "targetingDimensions": {
        "age": null,
        "gender": null,
        "country": null,
        "adminArea": null,
        "locality": null,
        "deviceClass": {
          "included": [
            "IPHONE",
            "IPAD"
          ]
        },
        "daypart": null,
        "appDownloaders": {
          "included": [],
          "excluded": []
        }
      },
      "orgId": 40669820,
      "modificationTime": "2026-04-08T23:30:17.280",
      "status": "ENABLED",
      "servingStatus": "RUNNING",
      "servingStateReasons": null,
      "displayStatus": "RUNNING",
      "deleted": false
    },
    {
      "id": 542370643,
      "campaignId": 56543219,
      "name": "Trip Trek ad group 2",
      "cpaGoal": null,
      "startTime": "2026-04-08T23:46:00.000",
      "endTime": "2026-04-09T05:00:00.000",
      "automatedKeywordsOptIn": true,
      "defaultCpcBid": {
        "amount": "1",
        "currency": "USD"
      },
      "pricingModel": "CPC",
      "targetingDimensions": {
        "age": null,
        "gender": null,
        "country": null,
        "adminArea": null,
        "locality": null,
        "deviceClass": {
          "included": [
            "IPHONE",
            "IPAD"
          ]
        },
        "daypart": null,
        "appDownloaders": {
          "included": [],
          "excluded": []
        }
      },
      "orgId": 40669820,
      "modificationTime": "2026-04-08T05:15:36.518",
      "status": "ENABLED",
      "servingStatus": "RUNNING",
      "servingStateReasons": [
        "null"
      ],
      "displayStatus": "RUNNING",
      "deleted": false
    },
    {
      "id": 542370644,
      "campaignId": 56543219,
      "name": "Trip Trek ad group 3",
      "cpaGoal": null,
      "startTime": "2026-04-08T23:45:00.000",
      "endTime": "2026-04-09T06:59:00.000",
      "automatedKeywordsOptIn": true,
      "defaultBidAmount": {
        "amount": "100",
        "currency": "USD"
      },
      "pricingModel": "CPC",
      "targetingDimensions": {
        "age": null,
        "gender": null,
        "country": null,
        "adminArea": null,
        "locality": null,
        "deviceClass": {
          "included": [
            "IPHONE",
            "IPAD"
          ]
        },
        "daypart": null,
        "appDownloaders": {
          "included": [],
          "excluded": []
        }
      },
      "orgId": 40669820,
      "modificationTime": "2026-04-08T07:15:21.110",
      "status": "ENABLED",
      "servingStatus": "NOT_RUNNING",
      "servingStateReasons": [
        "ADGROUP_END_DATE_REACHED"
      ],
      "displayStatus": "ON_HOLD",
      "deleted": false
    },
    {
      "id": 542370645,
      "campaignId": 56543219,
      "name": "Trip Trek ad group 4",
      "cpaGoal": {
        "amount": "100",
        "currency": "USD"
      },
      "startTime": "2026-04-08T19:10:31.650",
      "endTime": "2026-04-09T19:33:31.650",
      "automatedKeywordsOptIn": false,
      "defaultBidAmount": {
        "amount": "1",
        "currency": "USD"
      },
      "pricingModel": "CPC",
      "targetingDimensions": {
        "age": {
          "included": [
            {
              "minAge": 20,
              "maxAge": 25
            }
          ]
        },
        "gender": {
          "included": [
            "M"
          ]
        },
        "country": null,
        "adminArea": null,
        "locality": null,
        "deviceClass": {
          "included": [
            "IPAD",
            "IPHONE"
          ]
        },
        "daypart": {
          "userTime": {
            "included": [
              1,
              3,
              22,
              24
            ]
          }
        },
        "appDownloaders": null
      },
      "orgId": 40669820,
      "modificationTime": "2026-04-08T18:06:20.305",
      "status": "ENABLED",
      "servingStatus": "RUNNING",
      "servingStateReasons": null,
      "displayStatus": "RUNNING",
      "deleted": false
    }
  ],
  "pagination": {
    "totalResults": 4,
    "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)