Skip to main content
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" }
      }
    ]
  }'
FieldDescription
textKeyword text
matchTypeUsually EXACT or BROAD
bidAmountOptional 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

  1. Pull the 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 to block irrelevant traffic.
  7. Compare paid behavior with organic Keyword Metrics.