<!--
{
  "availability" : [
    "Search Ads: 5.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "Apple_Ads",
  "identifier" : "/documentation/apple_ads/Get-a-Single-Impression-Share-Report",
  "metadataVersion" : "0.1.0",
  "role" : "Web Service Endpoint",
  "symbol" : {
    "kind" : "Web Service Endpoint",
    "modules" : [
      "Apple Ads"
    ],
    "preciseIdentifier" : "rest:apple_ads:get:v5-custom-reports-{}"
  },
  "title" : "Get a Single Impression Share Report"
}
-->

# Get a Single Impression Share Report

Fetches a single Impression Share report containing metrics and metadata.

## Discussion

### Payload example: A single impression share report

**Request:**

```
HTTP GET https://api.searchads.apple.com/api/v5/custom-reports/{reportId}
```

**Response:**

```json
{
  "data": {
    "id": 7615231,
    "name": "impression_share_API_report_example_2",
    "startTime": "2024-06-01",
    "endTime": "2024-06-30",
    "granularity": "DAILY",
    "downloadUri": "https://ads-...us-west-2.amazonaws.com/ext-sov-reports/",
    "dimensions": [
      "appName",
      "adamId",
      "countryOrRegion",
      "searchTerm"
    ],
    "metrics": [
      "lowImpressionShare",
      "highImpressionShare",
      "rank",
      "searchPopularity"
    ],
    "selector": {
      "conditions": [
        {
          "field": "adamId",
          "operator": "IN",
          "values": [
            "1252497129",
            "282614216"
          ]
        },
        {
          "field": "countryOrRegion",
          "operator": "IN",
          "values": [
            "US",
            "AU"
          ]
        }
      ]
    },
    "state": "COMPLETED",
    "creationTime": "2024-02-07T09:14:46.235",
    "modificationTime": "2024-02-07T09:14:53.173",
    "dateRange": "LAST_2_WEEKS"
  },
  "pagination": null,
  "error": null
}
```

---

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)