---
title: Campaigns 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-campaign-reports
---

# Campaigns Report (Brands)

Retrieve performance metrics for Apple Maps campaigns.

## URL

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

## Header Parameters

X-Ap-Context:

## Response Codes

200 OK: Successful response. Returns BrandsCampaignReportResponse (result: BrandsCampaignResultContainer). 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 These reports return one row per campaign. Each row contains a metadata object with campaign identifiers, totalMetrics aggregated over the full date range, and a granularMetrics array broken down by the selected granularity. Use filters to scope results to specific campaigns by campaignId. Use groupBy to split metrics along a dimension: each dimension value produces its own row within the campaign’s result. See Filter for the full set of supported comparison operators. Request Body See BrandsReportingRequest. Brand campaign reports can be grouped by device type, business location, or ad placement.  |   |   |   |  The following metrics are available for brand campaign reports, covering spend, engagement, and the individual Apple Maps action types.  |   |   |   |   |   |   |   |   |   |   |   |   |   |   |   |   |   |   |   |   |  Granularity constraints follow the usual date range rules, from a 7-day lookback for HOURLY to a 90-day-old end date for MONTHLY.  |   |   |   |   |  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, and only ORTZ or UTC timezones are accepted.  |   |   |  Payload Examples

## See Also

- [Ad Groups Report (Brands)](apple-ads-platform-api/get-brand-ad-group-reports.md)
- [Ads Report (Brands)](apple-ads-platform-api/get-brand-ad-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)