> ## Documentation Index
> Fetch the complete documentation index at: https://docs.appeeky.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Apple Search Ads Reports

> Pull keyword performance and search terms reports from Apple Search Ads

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

| Endpoint                                                               | Description                            |
| ---------------------------------------------------------------------- | -------------------------------------- |
| `POST /v1/connect/apple-ads/campaigns/:campaignId/reports/keywords`    | Performance by targeting keyword       |
| `POST /v1/connect/apple-ads/campaigns/:campaignId/reports/searchterms` | Real search queries that triggered ads |

Both endpoints accept the same query parameters:

| Parameter | Description                                                      |
| --------- | ---------------------------------------------------------------- |
| `from`    | Start date, `YYYY-MM-DD`                                         |
| `to`      | End date, `YYYY-MM-DD`                                           |
| `days`    | Trailing window when `from` and `to` are omitted. Default is 30. |
| `limit`   | Max rows. Default 50, max 200.                                   |

## Search Terms Report

```bash curl theme={"theme":{"light":"github-light","dark":"github-dark"}}
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

```bash curl theme={"theme":{"light":"github-light","dark":"github-dark"}}
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](/docs/keyword-metrics).
5. Compare with organic rankings from [Keyword Rankings](/docs/get-keyword-ranks).
6. Add strong terms to metadata experiments or briefs.
7. Add irrelevant terms to [Negative Keywords](/docs/apple-search-ads-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:

| Signal                  | How to use it                                  |
| ----------------------- | ---------------------------------------------- |
| Search term impressions | Indicates paid inventory seen by your campaign |
| Suggested bids          | Indicates competitive pressure                 |
| Tap rate                | Indicates ad relevance                         |
| Install rate            | Indicates conversion intent                    |
| Spend                   | Indicates where budget is being consumed       |

For broader market demand, pair Search Ads data with [Keyword Metrics](/docs/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](/docs/overview) if available for the market you are researching.

To join Apple Ads spend with RevenueCat revenue, see [Apple Search Ads Profitability](/docs/apple-search-ads-profitability).