PyPI version Python License CI
A command-line interface for managing Apple Search Ads campaigns.
Built on top of asa-api-client.
Using uv (recommended):
uv tool install asa-api-cli
Using pip:
pip install asa-api-cli
Using pipx:
pipx install asa-api-cli
Set up your Apple Search Ads API credentials:
export ASA_CLIENT_ID="SEARCHADS.your-client-id" export ASA_TEAM_ID="SEARCHADS.your-team-id" export ASA_KEY_ID="your-key-id" export ASA_ORG_ID="123456" export ASA_PRIVATE_KEY_PATH="/path/to/private-key.pem"
Or use a .env file in your working directory.
Test your credentials:
asa auth test# List all enabled campaigns asa campaigns list # List all campaigns (including paused) asa campaigns list --all # List with 7-day spend data asa campaigns list --with-spend # Get a specific campaign asa campaigns get 123456789 # Output as JSON asa campaigns list --json
# List ad groups in a campaign
asa ad-groups list 123456789# List keywords in an ad group
asa keywords list 123456789 987654321# Campaign performance report asa reports campaigns --start 2024年01月01日 --end 2024年01月31日 # Keyword report asa reports keywords 123456789 --start 2024年01月01日 --end 2024年01月31日 # Export to CSV asa reports campaigns --start 2024年01月01日 --end 2024年01月31日 --output report.csv
Create brand protection campaigns for your app:
# Interactive mode (recommended) asa brand # With arguments asa brand "My App Name" -v "My App" -c US -c GB # All standard countries asa brand "My App Name" --country all # Preview without creating asa brand "My App Name" -c US --dry-run
Expand existing campaigns to new markets:
# Interactive mode asa optimize expand # With filters asa optimize expand --type Generic --match EM # Preview asa optimize expand --dry-run
Check and fix bid discrepancies:
# Check bids asa optimize bid-check # Auto-fix discrepancies asa optimize bid-check --auto-fix # With threshold asa optimize bid-check --threshold 0.05
Install shell completion for your shell:
# Bash asa --install-completion bash # Zsh asa --install-completion zsh # Fish asa --install-completion fish
MIT License - Copyright (c) 2025 Peth Pty Ltd