--- title: Impression Share Query framework: Apple Ads Platform API role: symbol role_heading: Web Service Endpoint platforms: [apple ads platform api 1.0+] path: apple-ads-platform-api/query-app-impression-share-data --- # Impression Share Query Retrieve impression share data showing how often your ads appear relative to total eligible impressions for a given search term and country. ## URL POST https://api.ads.apple.com/v1/insights/apps/impression-share/query ## Header Parameters X-Ap-Context: ## Response Codes 200 OK: Successful response. Returns ImpressionShareQueryResponse (result: ImpressionShareResultContainer). 400 Bad Request: Bad Request. Returns Error. 401 Unauthorized: Unauthorized. 403 Forbidden: Forbidden. 404 Not Found: Not Found. Returns Error. 429 Too Many Requests: Rate Limit Exceeded. Returns Error. 500 Internal Server Error: Internal Server Error. Returns Error. ## Discussion Discussion This endpoint measures impression share: what fraction of available impressions your app captures for a given search term and country. To identify competitive gaps, use this data. A low impression share on a high-volume term indicates that either budget, bid, or eligibility constraints are limiting your reach. See Filter for the full set of supported comparison operators. Filterable Fields | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Output Types Configure the output type via options.impressionShareReportType: | | | Each row in the response carries the following fields. | | | | | | | | | | | Impression Share Encoding The lowImpressionShare and highImpressionShare fields use a tiered encoding, not a continuous range: | | | | | | | | For single-digit values (1–90%), both fields are equal. When highImpressionShare equals 1, the app has >90% impression share. The encoding preserves the range at that level to avoid false precision near market saturation. The following limits and defaults apply to this endpoint’s requests and responses. | | | | | | | | | | | Estimate Market Size To estimate total eligible inventory for a search term, use impression share alongside confirmed impressions: estimated_market_impressions ≈ confirmed_impressions / lowImpressionShare Example: 10,000 confirmed impressions at lowImpressionShare: 0.04 (4%) → ≈ 250,000 total eligible impressions. The same app at lowImpressionShare: 0.91 (>90% bucket) has captured nearly all available inventory. Single-digit precision makes this estimate meaningful across the 1–90% range covered by lowImpressionShare. Only within the 91–100% bucket, where lowImpressionShare and highImpressionShare diverge to 0.91 and 1.0, does the estimate lose that precision. Payload Examples ## See Also - [Search Term Popularity Query](apple-ads-platform-api/query-app-search-term-popularity-data.md)