Report Endpoints
Both endpoints accept the same query parameters:
Search Terms Report
curl
- New keyword ideas
- Queries worth adding as exact-match targeting keywords
- Queries that should become negative keywords
- Differences between paid search behavior and organic keyword rankings
- Terms that convert well but are not yet in your metadata
Keyword Performance Report
curl
- Which paid keywords are efficient?
- Which keywords spend but do not install?
- Which keywords are good candidates for organic metadata?
- Which terms need bid changes?
- Which terms need exact vs broad match changes?
Example ASO Analysis Flow
- Pull the search terms report for the last 30 days.
- Sort by installs, conversion, or spend.
- Mark high-performing queries as ASO candidates.
- Check each candidate in Keyword Metrics.
- Compare with organic rankings from Keyword Rankings.
- Add strong terms to metadata experiments or briefs.
- Add irrelevant terms to Negative Keywords.
Search Popularity
Apple does not expose the Search Popularity score from the Search Ads UI through a public API. The API can still provide useful signals:
For broader market demand, pair Search Ads data with Keyword Metrics.
Reporting Caveats
- Search terms only include your own campaigns.
- Low-volume data may be limited by Apple.
- Reports depend on campaign setup, countries, bids, and budget.
- A campaign with no spend may return little or no report data.
- Search Ads reporting is not a competitor ad intelligence API.

