> ## 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.

# Targeting Keywords

> List, find, create, update, delete, and get recommendations for Apple Search Ads targeting keywords

Targeting keywords tell Apple which searches your ads can appear for. Appeeky supports full targeting keyword management for connected Search Ads campaigns and ad groups.

> [!WARNING]
>
> Create, update, and delete endpoints write to Apple Search Ads.

***

## List Keywords in an Ad Group

```bash curl theme={"theme":{"light":"github-light","dark":"github-dark"}}
curl "https://api.appeeky.com/v1/connect/apple-ads/campaigns/2143596801/adgroups/2147258884/targetingkeywords?limit=50&offset=0" \
  -H "X-API-Key: YOUR_APPEEKY_KEY"
```

Use this to inspect keyword text, match type, bid, status, and Apple IDs.

***

## Get One Keyword

```bash curl theme={"theme":{"light":"github-light","dark":"github-dark"}}
curl "https://api.appeeky.com/v1/connect/apple-ads/campaigns/2143596801/adgroups/2147258884/targetingkeywords/2251741048" \
  -H "X-API-Key: YOUR_APPEEKY_KEY"
```

***

## Find Keywords Across a Campaign

```bash curl theme={"theme":{"light":"github-light","dark":"github-dark"}}
curl -X POST "https://api.appeeky.com/v1/connect/apple-ads/campaigns/2143596801/targetingkeywords/find" \
  -H "X-API-Key: YOUR_APPEEKY_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "conditions": [
      {
        "field": "text",
        "operator": "CONTAINS",
        "values": ["screenshot"]
      }
    ],
    "pagination": {
      "offset": 0,
      "limit": 50
    }
  }'
```

The body follows Apple's selector-style filtering model.

***

## Create Keywords

```bash curl theme={"theme":{"light":"github-light","dark":"github-dark"}}
curl -X POST "https://api.appeeky.com/v1/connect/apple-ads/campaigns/2143596801/adgroups/2147258884/targetingkeywords/bulk" \
  -H "X-API-Key: YOUR_APPEEKY_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "keywords": [
      {
        "text": "screenshot maker",
        "matchType": "EXACT",
        "bidAmount": { "amount": "0.80", "currency": "USD" }
      },
      {
        "text": "app screenshot",
        "matchType": "BROAD",
        "bidAmount": { "amount": "0.50", "currency": "USD" }
      }
    ]
  }'
```

| Field | Description |
| - | - |
| `text` | Keyword text |
| `matchType` | Usually `EXACT` or `BROAD` |
| `bidAmount` | Optional keyword-level CPT bid |

***

## Update Keywords

```bash curl theme={"theme":{"light":"github-light","dark":"github-dark"}}
curl -X PUT "https://api.appeeky.com/v1/connect/apple-ads/campaigns/2143596801/adgroups/2147258884/targetingkeywords/bulk" \
  -H "X-API-Key: YOUR_APPEEKY_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "keywords": [
      {
        "id": 2251741048,
        "status": "ENABLED",
        "bidAmount": { "amount": "0.60", "currency": "USD" }
      }
    ]
  }'
```

Use this to pause/resume keywords or adjust bids.

***

## Delete Keywords

```bash curl theme={"theme":{"light":"github-light","dark":"github-dark"}}
curl -X POST "https://api.appeeky.com/v1/connect/apple-ads/campaigns/2143596801/adgroups/2147258884/targetingkeywords/delete" \
  -H "X-API-Key: YOUR_APPEEKY_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "keywordIds": [2251741048]
  }'
```

Apple treats deletion according to Search Ads API behavior for that keyword resource.

***

## Keyword Recommendations

```bash curl theme={"theme":{"light":"github-light","dark":"github-dark"}}
curl -X POST "https://api.appeeky.com/v1/connect/apple-ads/campaigns/2143596801/adgroups/2147258884/targetingkeywords/recommendations" \
  -H "X-API-Key: YOUR_APPEEKY_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

Recommendations are keyword ideas for the campaign's app and countries, each with Apple's 0–100 popularity score. Pass `keywords` to seed related ideas, or `adamId` and `countriesOrRegions` to override the campaign's.

***

## Bid Recommendations

```bash curl theme={"theme":{"light":"github-light","dark":"github-dark"}}
curl -X POST "https://api.appeeky.com/v1/connect/apple-ads/campaigns/2143596801/adgroups/2147258884/bid-recommendations" \
  -H "X-API-Key: YOUR_APPEEKY_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "keywords": ["screenshot maker", "app screenshot"],
    "matchType": "EXACT",
    "countriesOrRegions": ["US"]
  }'
```

Bid recommendations come from Apple's keyword report, so they're available for keywords that are already in the ad group and have some delivery. Other keywords return `suggestedBidAmount: null`. They're useful for paid keyword planning, but they aren't organic search volume.

***

## ASO Workflow

1. Pull the [search terms report](https://docs.appeeky.com/docs/apple-search-ads-reports.md#search-terms-report).
2. Identify terms with good tap/install behavior.
3. Check whether those terms are already targeting keywords.
4. Add exact-match keywords for high-confidence queries.
5. Add broad-match keywords for controlled exploration.
6. Use [negative keywords](https://docs.appeeky.com/docs/apple-search-ads-negative-keywords.md) to block irrelevant traffic.
7. Compare paid behavior with organic [Keyword Metrics](https://docs.appeeky.com/docs/keyword-metrics.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.