---
title: Ads Report (Brands)
framework: Apple Ads Platform API
role: symbol
role_heading: Web Service Endpoint
platforms: [apple ads platform api 1.0+]
path: apple-ads-platform-api/get-brand-ad-reports
---

# Ads Report (Brands)

Retrieve performance metrics for Apple Maps ads.

## URL

POST https://api.ads.apple.com/v1/reports/business-brands/ads/query

## Header Parameters

X-Ap-Context:

## Response Codes

200 OK: Successful response. Returns BrandsAdReportResponse (result: BrandsAdResultContainer). 400 Bad Request: Bad Request. Returns ErrorResponse. 401 Unauthorized: Unauthorized. 403 Forbidden: Forbidden. 404 Not Found: Not Found. Returns ErrorResponse. 429 Too Many Requests: Rate Limit Exceeded. Returns ErrorResponse. 500 Internal Server Error: Internal Server Error. Returns ErrorResponse.

## Discussion

Discussion Brand ad reports return one row per ad. Each row contains a metadata object with ad identifiers (including campaignId and adGroupId), totalMetrics aggregated over the full date range, and a granularMetrics array broken down by the selected granularity. For Apple Maps ads, the metadata object includes a nested creative object (BrandsReportingCreative) with the creative’s id, creativeType, and systemStatus. There is no flat creativeId field. Filter by adGroupId or campaignId in the filters array to scope results. See Filter for the full set of supported comparison operators. Request Body See BrandsReportingRequest. Brand ad reports can be grouped by device type, business location, or ad placement.  |   |   |   |  Ad reports follow the standard date range rules per granularity, except HOURLY isn’t available at the ad level.  |   |   |   |   |  To request a single day of data, omit granularity entirely. For a single-day request, the response returns results in totalMetrics only, since there is no granularMetrics breakdown to compute. The EMPTY_METRICS value isn’t supported for business-brands ads, HOURLY granularity isn’t available, and only ORTZ or UTC timezones are accepted.  |   |   |   |  Payload Examples

## See Also

- [Campaigns Report (Brands)](apple-ads-platform-api/get-brand-campaign-reports.md)
- [Ad Groups Report (Brands)](apple-ads-platform-api/get-brand-ad-group-reports.md)
- [Keywords Report (Brands)](apple-ads-platform-api/get-brand-keyword-reports.md)
- [Search Terms Report (Brands)](apple-ads-platform-api/get-brand-search-term-reports.md)