v0.2.0

What's New

✨ CLI Standards Overhaul

• Added global --quiet/-q, --verbose/-v, --json, --no-input, and --no-color flags
• All diagnostic output now routes to stderr; data output to stdout (pipe-friendly)
• TTY detection: spinners, progress bars, and prompts automatically disabled when piped
• Named exit codes: 0 (success), 1 (runtime error), 2 (usage/validation error)
• Next-command hints after campaign pause/enable/set-budget and keyword add operations

✨ New Commands

• Campaign expansion (asa optimize expand) — clone campaigns across new countries
• CPA goal optimization (asa optimize cpa-goal) — analyze and set CPA goals
• SKAG creation (asa ad-groups skag) — single keyword ad groups with interactive workflows
• Keyword translation (asa translate keywords) — AI-powered keyword translation across languages

✨ Impression Share Enhancements

• Added asa impression-share correlate for bid-to-impression analysis
• Added asa optimize bid-review for bid strength optimization
• Multi-country support and app grouping in analysis output

♻️ Breaking Changes

• Keyword commands: campaign_id and ad_group_id changed from positional args to --campaign and --ad-group/-g flags
• --version no longer has -v shorthand (now used for --verbose)

🐛 Bug Fixes

• Fixed impression-share bid update using correct bulk API endpoint
• Fixed keyword matching in bid-review interactive mode
• Deprecated ASA_PRIVATE_KEY env var in favour of ASA_PRIVATE_KEY_PATH

⬆️ Dependencies

• Upgraded asa-api-client to >=0.1.5 for improved retry and CustomReport support
• Bumped cryptography 46.0.3→46.0.5 (security fix)
• Bumped filelock 3.20.0→3.21.1 (security fix)
• Bumped virtualenv 20.35.4→20.36.1

v0.1.0 - Initial Release

Initial Release

Command-line interface for Apple Search Ads campaign management.

Features

• Campaign Management: List, create, update, and delete campaigns
• Ad Group Management: Full CRUD operations for ad groups
• Keyword Management: Manage targeting and negative keywords
• Reports: Generate campaign, ad group, keyword, and search term reports
• Optimization Tools:
  • asa optimize bid-check - Find bid discrepancies between ad groups and keywords
  • asa optimize expand - Expand successful campaigns to new countries
• Brand Campaigns: Create brand campaigns across multiple countries with asa brand

Installation

# Using uv (recommended)
uv tool install asa-api-cli

# Using pip
pip install asa-api-cli

# Using pipx
pipx install asa-api-cli

Requirements

• Python 3.13+
• Apple Search Ads API credentials

Dependencies

• asa-api-client - Core API client library
• Typer - CLI framework
• Rich - Terminal formatting