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

# BrandsSearchTermReportRow

A single row in a Brands search term report, pairing search-term metadata with total and granular performance metrics.

## Declaration

```data
object BrandsSearchTermReportRow
```

## Properties

totalMetrics: See BrandsMetrics for details. granularMetrics: Time-series metrics broken down by the requested granularity. Present only when the request specifies a granularity. Otherwise, it’s omitted and all data appears in totalMetrics. metadata: See BrandsReportingSearchTerm for details.

## Discussion

Discussion The BrandsSearchTermReportRow object is the brands counterpart to AppsSearchTermReportRow. The metadata field captures the search term text and its associated keyword, ad group, and location context at report time. The totalMetrics field contains the aggregated performance figures across the full reporting period. Like all search term reports, brands search term reports require the ORTZ timezone. UTC isn’t supported. Search term entity reports also exclude the supplyPlacement and locationId dimensions from groupBy. Example {   "totalMetrics": {     "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"     },     "firstActions": {       "tap": 1450     },     "firstActionsPerTap": {       "tap": 0.1480     },     "firstActionsPerImpression": {       "tap": 0.0023     },     "costPerFirstAction": {       "tap": {         "amount": "0.58",         "currency": "USD"       }     },     "actions": {       "tap": 2100     },     "costPerAction": {       "tap": {         "amount": "0.40",         "currency": "USD"       }     },     "getDirections": {       "tap": 320     },     "tapURL": {       "tap": 610     },     "call": {       "tap": 145     },     "share": {       "tap": 95     },     "getTheApp": {       "tap": 780     },     "galleryEngagement": {       "tap": 150     },     "actionsPerTap": {       "tap": 0.2143     },     "actionsPerImpression": {       "tap": 0.0034     }   },   "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"       },       "firstActions": {         "tap": 1450       },       "firstActionsPerTap": {         "tap": 0.1480       },       "firstActionsPerImpression": {         "tap": 0.0023       },       "costPerFirstAction": {         "tap": {           "amount": "0.58",           "currency": "USD"         }       },       "actions": {         "tap": 2100       },       "costPerAction": {         "tap": {           "amount": "0.40",           "currency": "USD"         }       },       "getDirections": {         "tap": 320       },       "tapURL": {         "tap": 610       },       "call": {         "tap": 145       },       "share": {         "tap": 95       },       "getTheApp": {         "tap": 780       },       "galleryEngagement": {         "tap": 150       },       "actionsPerTap": {         "tap": 0.2143       },       "actionsPerImpression": {         "tap": 0.0034       }     }   ],   "metadata": {     "campaignId": 555666777,     "adAccountId": 123456789,     "searchTermText": "AwayFinder",     "searchTermSource": "SEARCH",     "keyword": {       "locationId": "555666777",       "matchType": "PHRASE"     },     "adGroupId": 987654321,     "adGroup": {       "name": "AwayFinder Brand Ad Group",       "deleted": false     },     "countryOrRegion": "US",     "deviceClass": "IPHONE"   } }

## 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)