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

# AppsSearchTermReportResponse

The top-level response envelope for apps search term reports.

## Declaration

```data
object AppsSearchTermReportResponse
```

## Properties

result: Contains the array of search term rows, each capturing the actual user query text and associated performance metrics. If no rows match the request, result is returned as an empty object. See AppsSearchTermResultContainer for details. pagination: See ResponsePagination for details. error: See ErrorResponse for details.

## Discussion

Discussion Search term reports require the ORTZ timezone. UTC isn’t supported. Each row links back to the matched keyword via a nested keyword object (see ReportingKeyword), enabling you to map observed search behavior to specific bids. Example {   "result": {     "rows": [       {         "metadata": {           "campaignId": 444555666,           "adAccountId": 123456789,           "searchTermText": "awayfinder travel app",           "searchTermSource": "SEARCH",           "keyword": {             "id": 987654321,             "campaignId": 444555666,             "adAccountId": 123456789,             "deleted": false,             "text": "travel app",             "status": "ENABLED",             "matchType": "BROAD",             "bid": {               "amount": "0.85",               "currency": "USD"             },             "adGroupId": 555666777,             "modificationTime": "2025-01-05T08:00:00.000",             "creationTime": "2024-11-01T08:00:00.000",             "displayStatus": "RUNNING",             "adGroup": {               "name": "AwayFinder - Broad Match",               "deleted": false             },             "countryOrRegion": "US",             "deviceClass": "IPHONE"           },           "adGroupId": 555666777,           "adGroup": {             "name": "AwayFinder - Broad Match",             "deleted": false           },           "countryOrRegion": "US",           "deviceClass": "IPHONE"         },         "totalMetrics": {           "date": "2025-01-10",           "localSpend": {             "amount": "142.30",             "currency": "USD"           },           "impressions": 48200,           "taps": 910,           "ttr": 0.0189,           "cpt": {             "amount": "0.16",             "currency": "USD"           },           "cpm": {             "amount": "2.95",             "currency": "USD"           },           "tapInstalls": 182,           "tapInstallCPI": {             "amount": "0.78",             "currency": "USD"           },           "totalNewDownloads": 201,           "totalRedownloads": 16,           "viewInstalls": 34,           "totalInstalls": 216,           "tapNewDownloads": 168,           "tapRedownloads": 14,           "viewNewDownloads": 30,           "viewRedownloads": 4,           "totalAvgCPI": {             "amount": "0.66",             "currency": "USD"           },           "totalInstallRate": 0.2374,           "tapInstallRate": 0.2,           "tapPreOrdersPlaced": 6,           "viewPreOrdersPlaced": 1,           "totalPreOrdersPlaced": 7         },         "granularMetrics": []       }     ],     "summary": {       "grandTotal": {         "date": "2025-01-10",         "localSpend": {           "amount": "142.30",           "currency": "USD"         },         "impressions": 48200,         "taps": 910,         "ttr": 0.0189,         "cpt": {           "amount": "0.16",           "currency": "USD"         },         "cpm": {           "amount": "2.95",           "currency": "USD"         },         "tapInstalls": 182,         "tapInstallCPI": {           "amount": "0.78",           "currency": "USD"         },         "totalNewDownloads": 201,         "totalRedownloads": 16,         "viewInstalls": 34,         "totalInstalls": 216,         "tapNewDownloads": 168,         "tapRedownloads": 14,         "viewNewDownloads": 30,         "viewRedownloads": 4,         "totalAvgCPI": {           "amount": "0.66",           "currency": "USD"         },         "totalInstallRate": 0.2374,         "tapInstallRate": 0.2,         "tapPreOrdersPlaced": 6,         "viewPreOrdersPlaced": 1,         "totalPreOrdersPlaced": 7       }     }   },   "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)