---
title: BrandsKeywordReportResponse
framework: Apple Ads Platform API
role: symbol
role_heading: Object
platforms: [apple ads platform api 1.0+]
path: apple-ads-platform-api/brandskeywordreportresponse
---

# BrandsKeywordReportResponse

The top-level response envelope for brands keyword-level reports.

## Declaration

```data
object BrandsKeywordReportResponse
```

## Properties

result: Wraps the report rows, each containing keyword metadata and associated brands performance metrics. If no rows match the request, result is returned as an empty object. See BrandsKeywordResultContainer for details. pagination: See ResponsePagination for details. error: See ErrorResponse for details.

## Discussion

Discussion The brands keyword reports exclude both supplyPlacement and locationId from supported groupBy dimensions. Use deviceClass only. Example {   "result": {     "rows": [       {         "metadata": {           "locationId": "555666777",           "matchType": "PHRASE"         },         "totalMetrics": {           "date": "2025-01-10",           "localSpend": {             "amount": "845.50",             "currency": "USD"           },           "impressions": 620000,           "taps": 9800,           "ttr": 0.0158,           "cpt": {             "amount": "0.09",             "currency": "USD"           },           "cpm": {             "amount": "1.36",             "currency": "USD"           }         },         "granularMetrics": [           {             "date": "2025-01-10",             "localSpend": {               "amount": "845.50",               "currency": "USD"             },             "impressions": 620000,             "taps": 9800,             "ttr": 0.0158,             "cpt": {               "amount": "0.09",               "currency": "USD"             },             "cpm": {               "amount": "1.36",               "currency": "USD"             }           }         ],         "insights": {           "bidRecommendation": {             "suggestedBidAmount": 2.35           }         }       }     ],     "summary": {       "grandTotal": {         "date": "2025-01-10",         "localSpend": {           "amount": "845.50",           "currency": "USD"         },         "impressions": 620000,         "taps": 9800,         "ttr": 0.0158,         "cpt": {           "amount": "0.09",           "currency": "USD"         },         "cpm": {           "amount": "1.36",           "currency": "USD"         }       }     }   },   "pagination": {     "offset": 0,     "pageSize": 20,     "totalCount": 1   } }

## See Also

- [BrandsReportingRequest](apple-ads-platform-api/brandsreportingrequest.md)
- [BrandsReportingCampaign](apple-ads-platform-api/brandsreportingcampaign.md)
- [BrandsReportingAdGroup](apple-ads-platform-api/brandsreportingadgroup.md)
- [BrandsReportingAd](apple-ads-platform-api/brandsreportingad.md)
- [BrandsReportingCreative](apple-ads-platform-api/brandsreportingcreative.md)
- [BrandsReportingKeyword](apple-ads-platform-api/brandsreportingkeyword.md)
- [BrandsReportingSearchTerm](apple-ads-platform-api/brandsreportingsearchterm.md)
- [BrandsCampaignReportResponse](apple-ads-platform-api/brandscampaignreportresponse.md)
- [BrandsCampaignReportRow](apple-ads-platform-api/brandscampaignreportrow.md)
- [BrandsCampaignReportSummary](apple-ads-platform-api/brandscampaignreportsummary.md)
- [BrandsCampaignResultContainer](apple-ads-platform-api/brandscampaignresultcontainer.md)
- [BrandsAdGroupReportResponse](apple-ads-platform-api/brandsadgroupreportresponse.md)
- [BrandsAdGroupReportRow](apple-ads-platform-api/brandsadgroupreportrow.md)
- [BrandsAdGroupReportSummary](apple-ads-platform-api/brandsadgroupreportsummary.md)
- [BrandsAdGroupResultContainer](apple-ads-platform-api/brandsadgroupresultcontainer.md)