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.

Create, update, and delete endpoints write to Apple Search Ads.

List Keywords in an Ad Group

curl

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

curl

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

curl

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

curl

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

curl

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

curl

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

curl

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

curl

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

Pull the search terms report.
Identify terms with good tap/install behavior.
Check whether those terms are already targeting keywords.
Add exact-match keywords for high-confidence queries.
Add broad-match keywords for controlled exploration.
Use negative keywords to block irrelevant traffic.
Compare paid behavior with organic Keyword Metrics.

Getting Started

Apps

My Data - Appeeky Web

Keywords

ASO Tools

AI Visibility

Search & Discovery

Market Intelligence

RevenueCat

App Store Connect

Google Play Console

Apple Search Ads

Reference

List Keywords in an Ad Group

Get One Keyword

Find Keywords Across a Campaign

Create Keywords

Update Keywords

Delete Keywords

Keyword Recommendations

Bid Recommendations

ASO Workflow

​List Keywords in an Ad Group

​Get One Keyword

​Find Keywords Across a Campaign

​Create Keywords

​Update Keywords

​Delete Keywords

​Keyword Recommendations

​Bid Recommendations

​ASO Workflow

List Keywords in an Ad Group

Get One Keyword

Find Keywords Across a Campaign

Create Keywords

Update Keywords

Delete Keywords

Keyword Recommendations

Bid Recommendations

ASO Workflow