---
title: Get Search Term-Level Reports
framework: Apple Ads
role: symbol
role_heading: Web Service Endpoint
platforms: [search ads 5.0+]
path: apple_ads/get-search-term-level-reports
---

# Get Search Term-Level Reports

Fetches reports for search terms within a campaign.

## URL

POST https://api.searchads.apple.com/api/v5/reports/campaigns/{campaignId}/searchterms

## Path Parameters

campaignId: The unique identifier for the campaign.

## Response Codes

200 OK: If the call succeeds, the API returns the ReportingResponse object in the response payload with an HTTP status code of 200 (OK). If unsuccessful, the HTTP status code indicates the error with details in the error message. 400 Bad Request: An invalid query or missing required parameters. 401 Unauthorized: An unauthenticated call fails to get the requested response. 403 Forbidden: Insufficient rights to the resource. 404 Not Found: The API can’t locate the resource. 429 : The API calls exceed rate-limit thresholds. See the Rate Limits subsection of Calling the Apple Ads API. 500 Internal Server Error: The Apple Ads server is temporarily down or unreachable. The request may be valid, but you need to retry it later.

## Mentioned in

Apple Ads Campaign Management API 4

## Discussion

Discussion Use this endpoint to fetch reports for search terms in your campaigns. See ReportingSearchTerm for Condition operators and field values to filter results with a Selector. The limit for search term-level reports is 10 impressions. Search term-level reports only support a timeZone value of ORTZ. The orderBy Selector specifies fields to sort the records list by ASCENDING or DESCENDING. All ReportingSearchTerm fields are available to the orderBy Selector. Payload example: Get search term-level reports

## HTTP Body

The report request body consisting of metrics and dimensions to use as filters.

## See Also

### Reports Endpoints

- [Get Campaign-Level Reports](apple_ads/get-campaign-level-reports.md)
- [Get Ad Group-Level Reports](apple_ads/get-ad-group-level-reports.md)
- [Get Keyword-Level Reports](apple_ads/get-keyword-level-reports.md)
- [Get Keyword-Level within Ad Group Reports](apple_ads/get-keyword-level-within-ad-group-reports.md)
- [Get Search Term-Level within Ad Group Reports](apple_ads/get-search-term-level-within-ad-group-reports.md)
- [Get Ad-Level Reports](apple_ads/get-ad-level-reports.md)