<!--
{
  "availability" : [
    "Search Ads: 5.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "Apple_Ads",
  "identifier" : "/documentation/apple_ads/Get-Ad-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-{}-ads"
  },
  "title" : "Get Ad-Level Reports"
}
-->

# Get Ad-Level Reports

Fetches ad performance data within a campaign.

## Discussion

Use this endpoint to return performance data for `ads` within your campaigns. The `orderBy` [`Selector`](/documentation/apple_ads/Selector) is required in ad-level report requests. See [`ReportingAd`](/documentation/apple_ads/ReportingAd) to identify fields you can use with `orderBy`. To filter results, use selector [`Condition`](/documentation/apple_ads/Condition) operators and field values that the `ReportingAd` object specifies. You can only perform `GroupBy` on the [`CountryOrRegion`](/documentation/apple_ads/CountryOrRegion) field. See [`ReportingRequest`](/documentation/apple_ads/ReportingRequest).

Historical ad-level metrics for the `APPSTORE_SEARCH_TAB` placement from before API version 5.2 release are reported against `adId=-1`. For `APPSTORE_SEARCH_TAB` ad-level metrics after API version 5.2 release, all default product page ads are reported against a new, real `adId` in reporting payloads.

You can map your campaign installations by `adId` through the <doc://com.apple.documentation/documentation/AdServices> attribution framework.

### Payload example: Get ad-level reports

**Request:**

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

{
  "startTime": "2025-10-07",
  "endTime": "2025-10-09",
  "selector": {
  "orderBy": [
      {
        "field": "creativeType",
        "sortOrder": "ASCENDING"
      }
    ],
    "conditions": [
      {
        "field": "adId",
        "operator": "EQUALS",
        "values": [
          "573408745"
        ]
      }
    ],
    "pagination": {
      "offset": 0,
      "limit": 1000
    }
  },
  "timeZone": "UTC",
  "returnRecordsWithNoMetrics": false,
  "returnRowTotals": true,
  "returnGrandTotals": true
}
```

**Response:**

```json
{
    "row": [
      {
        "other": false,
        "total": {
          "impressions": 41,
          "taps": 1,
          "totalInstalls": 1,
          "totalNewDownloads": 2,
          "totalRedownloads": 1,
          "viewInstalls": 1,
          "tapInstalls": 5,
          "tapNewDownloads": 2,
          "tapRedownloads": 3,
          "viewNewDownloads": 6,
          "viewReDownloads": 4,
          "tapPreOrdersPlaced": 1,
          "viewPreOrdersPlaced": 0,
          "totalPreOrdersPlaced": 0,
          "totalInstallRate": 2.962 
          "ttr": 0.0244,
          "tapInstallCPI": {
            "amount": "0",
            "currency": "USD"
            },
          "avgCPT": {
            "amount": "0.88",
            "currency": "USD"
            },
          "localSpend": {
            "amount": "0.88",
            "currency": "USD"
            },
          "tapInstallRate": 0.873,
          "date": "2025-08-10"
        },
        "metadata": {
          "orgId": 39872140,
          "campaignId": 570798765,
          "adGroupId": 427916203,
          "adId": 573408745,
          "productPageId": 45812c9b-c296-43d3-c6a0-c5a02f74bf6e,
          "language": "English",
          "creativeId": 94895512,
          "adName": "Trip Trek custom product page variation 1",
          "creativeType": "CUSTOM_PRODUCT_PAGE",
          "status": "VALID",
          "displayStatus": "ACTIVE",
          "adServingStateReasons": null,
          "deleted": false,
          "creationTime": "2025-10-08T06:48:22.812Z",
          "modificationTime": "2025-08-09T06:48:22.812Z"
        }
      }
    ]
  }
```

---

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)