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

# Impression Share Report

Obtain a report ID.

## Discussion

Use this endpoint to obtain a `reportId` to use in a [`Get a Single Impression Share Report`](/documentation/apple_ads/Get-a-Single-Impression-Share-Report) request. This endopoint supports selectors. See [`CustomReportRequest`](/documentation/apple_ads/CustomReportRequest) for selector structure.

- You can generate up to 10 reports within 24 hours.
- You can create reports for a range of up to 30 days for any time period after `2020-04-12`.
- You can’t edit or remove report fields.
- Impression Share reports with a `WEEKLY` granularity value can’t have custom `startTime` and `endTime` in the request payload. Use `dateRange` instead. See [`CustomReportRequest`](/documentation/apple_ads/CustomReportRequest).

### Payload example: Obtain a report ID

**Request:**

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

{
  "name": "impression_share_API_report_example_1",
  "startTime": "2024-01-20",
  "endTime": "2024-01-29",
  "granularity": "DAILY",
  "selector": {
    "conditions": [
      {
        "field": "countryOrRegion",
        "operator": "IN",
        "values": [
          "US",
          "AU"
        ]
      }
    ]
  }
}
```

**Response:**

```json
{
  "data": {
    "id": 986235,
    "name": "impression_share_API_report_example_1",
    "startTime": "2024-01-20",
    "endTime": "2024-01-29",
    "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"
          ]
        }
      ]
    },
    "state": "QUEUED",
    "creationTime": "2024-01-12T04:47:27.782",
    "modificationTime": "2024-01-12T04:47:27.782"
  },
  "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)