Skip to content
TakoAPI
Back to skills

apple-search-ads-skill

by trebuhs

Apple Apps & Services
469Downloads reported by clawskills.sh
2Stars
0Views
0 likesSign in to like this skill
—Not yet rated
Your rating

Brief

Manage Apple Search Ads campaigns, ad groups, keywords, and reports via the asa-cli tool.

Description

What This Skill Does

Manage Apple Search Ads campaigns, ad groups, keywords, and reports through the asa-cli command-line tool. Covers the full Campaign Management API v5, including keyword bidding, negative keywords, and performance reports broken down by date, country, and device.

Handles Apple Search Ads API v5 authentication and pagination automatically, so you can manage campaigns without writing custom HTTP code.

When to Use It

  • Pull last month's install and CPI report by country for a live campaign
  • Add negative keywords to an ad group to block irrelevant search terms
  • Adjust keyword bids across multiple ad groups before a seasonal push
  • Create a new campaign targeting specific countries for an app launch
  • Compare search term performance to find high-converting queries

Example Workflow

INPUT

User asks: Get keyword performance for campaign 123456 for the past 30 days

AGENT
  1. 1

    Run asa-cli whoami -o json to confirm the org ID

  2. 2

    Run asa-cli reports keywords --campaign-id 123456 --start-date 2026-02-17 --end-date 2026-03-19 -o json

  3. 3

    Pipe the output through jq to extract keyword text, totalInstalls, tapInstallCPI, and totalInstallRate

  4. 4

    Sort results by tapInstallCPI to surface the most and least efficient keywords

OUTPUT

A ranked list of keywords with install counts, tap-through install rate, and cost per install for the 30-day window

Requirements

  • Apple Search Ads account
  • Apple Search Ads API credentials: client ID, team ID, key ID, and private key file (generated in the ASA console)
  • asa-cli installed

Installation

clawhub install trebuhs/apple-search-ads-skill

Run the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.

Links