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

# Get All Impression Share Reports

Fetches all Impression Share reports containing metrics and metadata.

## Discussion

Use this endpoint to return all Impression Share reports containing metrics and metadata. Use query parameters as needed.

The rate limit for this endpoint is 150 reports within 15 minutes.

### Payload example:  All Impression Share reports

**Request:**

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

**Response:**

```json
{
  "data": [
    {
      "id": 965992,
      "name": "impression_share_report_example_3",
      "startTime": "2024-10-14",
      "endTime": "2024-11-12",
      "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": "countryOrRegion",
            "operator": "IN",
            "values": [
              "US",
              "AU"
            ]
          },
          {
            "field": "adamId",
            "operator": "IN",
            "values": [
              "1252497129",
              "282614216"
            ]
          }
        ]
      },
      "state": "COMPLETED",
      "creationTime": "2024-02-07T09:23:03.532",
      "modificationTime": "2024-02-07T09:23:09.774",
      "dateRange": "LAST_2_WEEKS"
    },
    {
      "id": 16627,
      "name": "impression_share_report_4",
      "startTime": "2024-09-15",
      "endTime": "2024-10-10",
      "granularity": "DAILY",
      "downloadUri": "http://blobstore.apple.com...",
      "dimensions": [
        "appName",
        "adamId",
        "countryOrRegion",
        "searchTerm"
      ],
      "metrics": [
        "lowImpressionShare",
        "highImpressionShare",
        "rank",
        "searchPopularity"
      ],
      "selector": {
        "conditions": [
          {
            "field": "countryOrRegion",
            "operator": "IN",
            "values": [
              "US",
              "AU"
            ]
          },
          {
            "field": "adamId",
            "operator": "IN",
            "values": [
              "1252497129",
              "282614216"
            ]
          }
        ]
      },
      "state": "COMPLETED",
      "creationTime": "2024-02-07T09:14:46.235",
      "modificationTime": "2024-02-07T09:14:53.173",
      "dateRange": "LAST_2_WEEKS"
    }
  ],
  "pagination": {
    "totalResults": 2,
    "startIndex": 0,
    "itemsPerPage": 2
  },
  "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)