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

# AppsKeywordReportResponse

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

## Declaration

```data
object AppsKeywordReportResponse
```

## Properties

result: Contains the array of keyword report rows, each including keyword metadata, associated performance metrics, and an optional insights.bidRecommendation. If no rows match the request, result is returned as an empty object. See AppsKeywordResultContainer for details. pagination: Provides pagination state for navigating large result sets. See ResponsePagination for details. error: See ErrorResponse for details.

## Discussion

Discussion Keyword reports support groupBy dimensions such as countryOrRegion and deviceClass, which adds those dimension values to each row’s metadata. Example {   "result": {     "rows": [       {         "metadata": {           "id": 888999000,           "text": "productivity app",           "matchType": "BROAD",           "adAccountId": 123456789,           "campaignId": 444555666,           "adGroupId": 555666777,           "status": "ENABLED",           "deleted": false         },         "totalMetrics": {           "localSpend": {             "amount": "75.00",             "currency": "USD"           },           "impressions": 5000,           "taps": 250,           "ttr": 0.05,           "cpt": {             "amount": "0.30",             "currency": "USD"           },           "tapInstalls": 60,           "totalInstalls": 72         },         "granularMetrics": [           {             "date": "2025-01-01",             "localSpend": {               "amount": "2.40",               "currency": "USD"             },             "impressions": 160,             "taps": 8,             "tapInstalls": 2           }         ],         "insights": {           "bidRecommendation": {             "suggestedBidAmount": 1.25           }         }       }     ],     "summary": {       "grandTotal": {         "localSpend": {           "amount": "482.50",           "currency": "USD"         },         "impressions": 152300,         "taps": 3210,         "ttr": 0.021,         "totalInstalls": 768       }     }   },   "pagination": {     "pageSize": 20,     "offset": 0,     "totalCount": 1   } }

## See Also

- [AppsReportingRequest](apple-ads-platform-api/appsreportingrequest.md)
- [AppsReportingCampaign](apple-ads-platform-api/appsreportingcampaign.md)
- [AppsReportingAdGroup](apple-ads-platform-api/appsreportingadgroup.md)
- [AppsReportingAd](apple-ads-platform-api/appsreportingad.md)
- [AppsReportingCreative](apple-ads-platform-api/appsreportingcreative.md)
- [AppsCampaignReportResponse](apple-ads-platform-api/appscampaignreportresponse.md)
- [AppsCampaignReportRow](apple-ads-platform-api/appscampaignreportrow.md)
- [AppsCampaignReportSummary](apple-ads-platform-api/appscampaignreportsummary.md)
- [AppsCampaignResultContainer](apple-ads-platform-api/appscampaignresultcontainer.md)
- [AppsAdGroupReportResponse](apple-ads-platform-api/appsadgroupreportresponse.md)
- [AppsAdGroupReportRow](apple-ads-platform-api/appsadgroupreportrow.md)
- [AppsAdGroupReportSummary](apple-ads-platform-api/appsadgroupreportsummary.md)
- [AppsAdGroupResultContainer](apple-ads-platform-api/appsadgroupresultcontainer.md)
- [AppsAdReportResponse](apple-ads-platform-api/appsadreportresponse.md)
- [AppsAdReportRow](apple-ads-platform-api/appsadreportrow.md)