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

***

## 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 '{}'
```

Apple returns recommendations when enough context is available for the ad group.

***

## 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 are useful for paid keyword planning, but they are not the same as organic search volume.

***

## ASO Workflow

1. Pull the [search terms report](/docs/apple-search-ads-reports#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](/docs/apple-search-ads-negative-keywords) to block irrelevant traffic.
7. Compare paid behavior with organic [Keyword Metrics](/docs/keyword-metrics).