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

# Get Ad Group-Level Reports

Fetches reports for ad groups within a campaign.

## Discussion

Use this endpoint to fetch reports for your ad groups in campaigns. See [`ReportingAdGroup`](/documentation/apple_ads/ReportingAdGroup) for [`Condition`](/documentation/apple_ads/Condition) operators and field values to filter results with an object [`Selector`](/documentation/apple_ads/Selector). See the `groupBy` parameter description in the [`ReportingRequest`](/documentation/apple_ads/ReportingRequest) for supported values per targeting dimension. The `orderBy` [`Selector`](/documentation/apple_ads/Selector) specifies fields to sort the records list by `ASCENDING` or `DESCENDING`. All [`ReportingAdGroup`](/documentation/apple_ads/ReportingAdGroup) fields are available to the `orderBy` [`Selector`](/documentation/apple_ads/Selector) except `adGroupServingStateReasons`.

### Payload example: Ad group-level reports using targeting criteria

**Request:**

```http
POST https://api.searchads.apple.com/api/v5/reports/campaigns/{campaignId}/adgroups

{
  "startTime": "2025-04-08",
  "endTime": "2025-04-09",
  "selector": {
    "orderBy": [
      {
        "field": "deviceClass",
        "sortOrder": "ASCENDING"
      }
    ],
    "conditions": [
      {
        "field": "deviceClass",
        "operator": "CONTAINS_ANY",
        "values": [
          "IPAD",
          "IPHONE"
        ]
      },
      {
        "field": "ageRange",
        "operator": "IN",
        "values": [
          "18-24",
          "25-34",
          "35-44",
          "45-54"
        ]
      }
    ],
    "pagination": {
      "offset": 0,
      "limit": 1000
    }
  },
  "groupBy": [
    "deviceClass",
    "ageRange"
  ],
  "timeZone": "UTC",
  "returnRecordsWithNoMetrics": true,
  "returnRowTotals": true,
  "returnGrandTotals": true
}
```

**Response:**

```json
{
  "row": [
    {
      "other": false,
      "granularity": [
        {
          "impressions": 210,
          "taps": 30,
          "ttr": 0.1429,
          "avgCPT": {
            "amount": "0.3783",
            "currency": "USD"
          },
          "avgCPM": {
            "amount": "0.2500",
            "currency": "USD"
          },
          "localSpend": {
            "amount": "11.35",
            "currency": "USD"
          },
          "totalInstalls": 10,
          "totalNewDownloads": 3,
          "totalRedownloads": 7,
          "viewInstalls": 18,
          "tapInstalls": 5,
          "tapNewDownloads": 2,
          "tapRedownloads": 3,
          "viewNewDownloads": 0,
          "viewReDownloads": 5,
          "tapPreOrdersPlaced": 0,
          "viewPreOrdersPlaced": 0,
          "totalPreOrdersPlaced": 0,
          "totalAvgCPI": {
            "amount": "1.57",
            "currency": "USD"
          },
          "totalInstallRate": 0.962,
          "tapInstallCPI": {
            "amount": "0.5974",
            "currency": "USD"
          },
          "date": "2024-04-08"
        },
        {
          "impressions": 198,
          "taps": 31,
          "ttr": 0.652,
          "avgCPT": {
            "amount": "0.83",
            "currency": "USD"
          },
          "avgCPM": {
            "amount": "0.2500",
            "currency": "USD"
          },
          "localSpend": {
            "amount": "11.35",
            "currency": "USD"
          },
          "totalInstalls": 13,
          "totalNewDownloads": 3,
          "totalRedownloads": 7,
          "viewInstalls": 18,
          "tapInstalls": 5,
          "tapNewDownloads": 2,
          "tapRedownloads": 3,
          "viewNewDownloads": 2,
          "viewReDownloads": 5,
          "tapPreOrdersPlaced": 0,
          "viewPreOrdersPlaced": 0,
          "totalPreOrdersPlaced": 0,
          "totalAvgCPI": {
            "amount": "1.76",
            "currency": "USD"
          },
          "totalInstallRate": 0.54,
          "tapInstallCPI": {
            "amount": "0.74",
            "currency": "USD"
          },
          "tapInstallRate": 0.76,
          "date": "2024-05-08"
        },
        {
          "impressions": 236,
          "taps": 29,
          "ttr": 0.1229,
          "avgCPT": {
            "amount": "0.4231",
            "currency": "USD"
          },
          "avgCPM": {
            "amount": "0.2500",
            "currency": "USD"
          },
          "localSpend": {
            "amount": "12.27",
            "currency": "USD"
          },
          "totalInstalls": 10,
          "totalNewDownloads": 3,
          "totalRedownloads": 7,
          "viewInstalls": 18,
          "tapInstalls": 5,
          "tapNewDownloads": 2,
          "tapRedownloads": 3,
          "viewNewDownloads": 0,
          "viewReDownloads": 5,
          "tapPreOrdersPlaced": 0,
          "viewPreOrdersPlaced": 0,
          "totalPreOrdersPlaced": 0,
          "totalInstallRate": 0.962,
          "tapInstallCPI": {
            "amount": "0.4908",
            "currency": "USD"
          },
          "tapInstallRate": 0.91,
          "date": "2024-04-08"
        }
      ],
      "metadata": {
        "adGroupId": 427916204,
        "adGroupName": "ad group example name",
        "startTime": "2024-04-08T00:00:00.000",
        "endTime": null,
        "cpaGoal": null,
        "pricingModel": "CPC",
        "defaultBidAmount": {
          "amount": "100",
          "currency": "USD"
        },
        "deleted": false,
        "adGroupStatus": "ENABLED",
        "adGroupServingStatus": "RUNNING",
        "adGroupServingStateReasons": null,
        "modificationTime": "2024-04-08T10:35:50.194",
        "automatedKeywordsOptIn": false,
        "automatedKeywordsRequired": false,
        "adGroupDisplayStatus": "RUNNING",
        "campaignId": 542370539,
        "orgId": 40669820,
        "countryOrRegion": "US",
        "deviceClass": "iPhone"
      }
    }
  ]
}
```

### Payload example: Ad group-level reports with manual ad groups

**Request:**

```http
POST https://api.searchads.apple.com/api/v5/reports/campaigns/{campaignId}/adgroups

{
  "startTime": "2025-04-08",
  "endTime": "2025-04-09",
  "selector": {
    "orderBy": [
      {
        "field": "defaultBidAmount",
        "sortOrder": "DESCENDING"
      }
    ],
    "conditions": [
      {
        "field": "defaultBidAmount",
        "operator": "BETWEEN",
        "values": [
          "99",
          "101"
        ]
      }
    ],
    "pagination": {
      "offset": 0,
      "limit": 34
    }
  },
  "timeZone": "UTC",
  "returnRecordsWithNoMetrics": false,
  "returnRowTotals": true,
  "returnGrandTotals": true
}
```

**Response:**

```json
{
      "row": [
        {
          "other": false,
          "total": {
            "impressions": 1200,
            "taps": 800,
            "ttr": 4,
            "avgCPT": {
              "amount": "0.625",
              "currency": "USD"
            },
            "avgCPM": {
              "amount": "2500",
              "currency": "USD"
            },
            "localSpend": {
              "amount": "3000",
              "currency": "USD"
            },
            "totalInstalls": 10,
            "totalNewDownloads": 3,
            "totalRedownloads": 7,
            "viewInstalls": 18,
            "tapInstalls": 5,
            "tapNewDownloads": 2,
            "tapRedownloads": 3,
            "viewNewDownloads": 0,
            "viewReDownloads": 5,
            "tapPreOrdersPlaced": 0,
            "viewPreOrdersPlaced": 0,
            "totalPreOrdersPlaced": 0,
            "totalAvgCPI": {
              "amount": "1.57",
              "currency": "USD"
           },
            "totalInstallRate": 0.962,
            "tapInstallCPI": {
              "amount": "0.8333",
              "currency": "USD"
            },
            "tapInstallRate": 0.91,
            "date": "2024-05-08"
          },
          "metadata": {
            "adGroupId": 427916203,
            "adGroupName": "ad group 2",
            "startTime": "2025-03-15T09:54:59.117",
            "endTime": "2025-09-11T09:54:59.117",
            "cpaGoal": null,
            "deleted": false,
            "adGroupStatus": "ENABLED",
            "adGroupServingStatus": "RUNNING",
            "adGroupServingStateReasons": null,
            "modificationTime": "2024-04-09T09:55:06.098",
            "automatedKeywordsOptIn": false,
            "automatedKeywordsRequired": false,
            "adGroupDisplayStatus": "RUNNING",
            "campaignId": 542370539,
            "orgId": 40669820,
            "pricingModel": "CPM",
            "defaultBidAmount": {
              "amount": "100",
              "currency": "USD"
            }
          }
        }
      ],
      "grandTotals": {
        "other": false,
        "total": {
            "impressions": 1020,
            "taps": 800,
            "ttr": 4,
            "avgCPT": {
              "amount": "0.625",
              "currency": "USD"
            },
            "avgCPM": {
              "amount": "2500",
              "currency": "USD"
            },
            "localSpend": {
              "amount": "300",
              "currency": "USD"
            },
            "totalInstalls": 10,
            "totalNewDownloads": 3,
            "totalRedownloads": 7,
            "viewInstalls": 18,
            "tapInstalls": 5,
            "tapNewDownloads": 2,
            "tapRedownloads": 3,
            "viewNewDownloads": 0,
            "viewReDownloads": 5,
            "tapPreOrdersPlaced": 0,
            "viewPreOrdersPlaced": 0,
            "totalPreOrdersPlaced": 0,
            "totalAvgCPI": {
              "amount": "1.57",
              "currency": "USD"
           },
            "totalInstallRate": 0.962,
            "tapInstallCPI": {
              "amount": "0.8333",
              "currency": "USD"
            },
            "tapInstallRate": 0.76,
            "date": "2024-05-09"
          }
      }
  }
```

### Payload example: Ad group-level reports with a Maximize Campaigns bid strategy

In Maximize Conversions bidding strategy in campaigns, you can use `biddingStrategy` and `automatedKeywordsRequired` in a selector for conditions and ordering. The `defaultBidAmount` is `0` and `cpaGoal` is `null`.

**Request:**

```http
POST https://api.searchads.apple.com/api/v5/reports/campaigns/{campaignId}/adgroups

{
  "startTime": "2025-10-23",
  "endTime": "2025-10-25",
  "selector": {
    "orderBy": [
      {
        "field": "biddingStrategy",
        "sortOrder": "DESCENDING"
      }
    ]
  },
  "timeZone": "UTC",
  "returnRecordsWithNoMetrics": true,
  "returnRowTotals": true,
  "returnGrandTotals": true
}
```

**Response:**

```json
{
  "reportingDataResponse": {
    "row": [
      {
        "metadata": {
          "campaignId": 886644762,
          "orgId": 19173940,
          "deleted": false,
          "modificationTime": "2025-10-13T16:58:21.582",
          "campaignName": "Ad Groups in Maximize Campaigns",
          "campaignStatus": "ENABLED",
          "app": {
            "appName": "TripTrek - explore the world",
            "adamId": 1131342792
          },
          "servingStatus": "RUNNING",
          "servingStateReasons": null,
          "countriesOrRegions": [
            "US"
          ],
          "totalBudget": null,
          "dailyBudget": {
            "amount": "300",
            "currency": "USD"
          },
          "displayStatus": "RUNNING",
          "supplySources": [
            "APPSTORE_SEARCH_RESULTS"
          ],
          "adChannelType": "DISPLAY",
          "countryOrRegionServingStateReasons": {},
          "billingEvent": "TAPS",
          "automatedKeywordsRequired": "true",
          "cpaGoal": null,
          "defaultBidAmount": {
            "amount": "0",
            "currency": "USD"
          },
          "biddingStrategy": "MAX_CONVERSIONS",
          "targetCpa": {
            "amount": "12",
            "currency": "USD"
          }
        },
        "total": {
          "...": "..."
        }
      }
    ]
  }
}
```

---

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)