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

# ReportingKeyword

Keyword metadata in a report row.

## Declaration

```data
object ReportingKeyword
```

## Properties

id: The keyword identifier. campaignId: The identifier of the campaign that owns the keyword. adAccountId: The identifier of the ad account that owns the keyword. deleted: true if the keyword has been deleted. text: The keyword text. status: Possible values: ENABLED, PAUSED. matchType: Possible values: BROAD, EXACT. bid: See Money for details. adGroupId: The identifier of the ad group that owns the keyword. modificationTime: The time the keyword was last modified. creationTime: The time the keyword was created. displayStatus: The computed display status of the keyword. adGroup: See ReportingAdGroupMin for details. countryOrRegion: Country or region groupBy dimension value. deviceClass: Device class groupBy dimension value.

## Discussion

Discussion The ReportingKeyword object is the keyword metadata embedded in keyword report rows and within search term rows (via the keyword field). It captures the keyword’s text, match type, bid amount, and status at report time, along with its organizational context (campaignId, adGroupId, adAccountId). The bid field is the keyword-level bid amount in the account currency, and adGroup provides a lightweight summary of the parent ad group. The report populates the dimension fields (countryOrRegion, deviceClass) when you specify those dimensions in the report request. Example {   "id": 555666777,   "campaignId": 123456789,   "adAccountId": 987654321,   "deleted": false,   "text": "awayfinder travel app",   "status": "ENABLED",   "matchType": "BROAD",   "bid": {     "currency": "USD",     "amount": "1.50"   },   "adGroupId": 234567891,   "modificationTime": "2025-01-10T08:00:00.000",   "creationTime": "2025-01-05T08:00:00.000",   "displayStatus": "RUNNING",   "adGroup": {     "name": "AwayFinder Search - Broad",     "deleted": false   },   "countryOrRegion": "US",   "deviceClass": "IPHONE" }

## See Also

- [TimeRange](apple-ads-platform-api/timerange.md)
- [Filter](apple-ads-platform-api/filter.md)
- [Sorting](apple-ads-platform-api/sorting.md)
- [RequestPagination](apple-ads-platform-api/requestpagination.md)
- [ReportingMoney](apple-ads-platform-api/reportingmoney.md)
- [ReportingBidStrategy](apple-ads-platform-api/reportingbidstrategy.md)
- [ReportingCampaignMin](apple-ads-platform-api/reportingcampaignmin.md)
- [ReportingAdGroupMin](apple-ads-platform-api/reportingadgroupmin.md)
- [ReportingCreativeSpec](apple-ads-platform-api/reportingcreativespec.md)
- [ReportingDestination](apple-ads-platform-api/reportingdestination.md)
- [ReportingSearchTerm](apple-ads-platform-api/reportingsearchterm.md)
- [ActionMetrics](apple-ads-platform-api/actionmetrics.md)
- [CostMetrics](apple-ads-platform-api/costmetrics.md)
- [RateMetrics](apple-ads-platform-api/ratemetrics.md)
- [ReportingAdChannelType](apple-ads-platform-api/reportingadchanneltype.md)