Skip to main content
Reports are the most useful Apple Search Ads data for ASO. They show how paid keywords and real user queries perform in your own campaigns.

​
Report Endpoints

EndpointDescription
POST /v1/connect/apple-ads/campaigns/:campaignId/reports/keywordsPerformance by targeting keyword
POST /v1/connect/apple-ads/campaigns/:campaignId/reports/searchtermsReal search queries that triggered ads
Both endpoints accept the same query parameters:
ParameterDescription
fromStart date, YYYY-MM-DD
toEnd date, YYYY-MM-DD
daysTrailing window when from and to are omitted. Default is 30.
limitMax rows. Default 50, max 200.

​
Search Terms Report

curl
curl -X POST \
  "https://api.appeeky.com/v1/connect/apple-ads/campaigns/2143596801/reports/searchterms?days=30&limit=50" \
  -H "X-API-Key: YOUR_APPEEKY_KEY"
Search terms are the exact queries users typed before seeing or tapping your ad. This is often the highest-signal Search Ads report for ASO work. Use it to find:
  • 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
curl -X POST \
  "https://api.appeeky.com/v1/connect/apple-ads/campaigns/2143596801/reports/keywords?from=2026-05-01&to=2026-06-01&limit=100" \
  -H "X-API-Key: YOUR_APPEEKY_KEY"
Keyword reports summarize performance for your targeting keywords. Typical metrics include impressions, taps, installs, spend, and suggested bid data where Apple returns it. Use it to answer:
  • 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

  1. Pull the search terms report for the last 30 days.
  2. Sort by installs, conversion, or spend.
  3. Mark high-performing queries as ASO candidates.
  4. Check each candidate in Keyword Metrics.
  5. Compare with organic rankings from Keyword Rankings.
  6. Add strong terms to metadata experiments or briefs.
  7. 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:
SignalHow to use it
Search term impressionsIndicates paid inventory seen by your campaign
Suggested bidsIndicates competitive pressure
Tap rateIndicates ad relevance
Install rateIndicates conversion intent
SpendIndicates where budget is being consumed
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.
For public competitor ad visibility, use Meta Ad Library Intelligence if available for the market you are researching. To join Apple Ads spend with RevenueCat revenue, see Apple Search Ads Profitability.