@sonarapp/cli · npm

The ASO CLI for your terminal

App Store Optimization as shell commands — keyword difficulty, search popularity, rankings, and competitor analysis for iOS & Android. Pipe it, script it, put it in CI.

npm install -g @sonarapp/cli
sonar auth login
sonar keywords search "habit tracker" --store ios --table

50 free credits on signup · No subscription required

[ 01 /04 ]·Commands//one binary//

The whole ASO workflow, one binary

Research, audit, track, export — the full Sonar API surface as subcommands.

COMMANDDESCRIPTION
sonar keywords searchKeyword research — difficulty + popularity for seed + related terms
sonar keywords metricsDifficulty + popularity for specific keywords (bulk supported)
sonar keywords suggestionsAutocomplete keyword suggestions
sonar apps search / lookupFind any app, inspect its listing metadata
sonar apps scoreASO audit score (0–100) for any app
sonar rankingsDaily rank history for your tracked apps
sonar competitors keywordsCompetitor keyword & gap analysis
sonar revenueMonthly revenue estimates (single or bulk)
sonar exportDump keywords/rankings to CSV or JSON
[ 02 /04 ]·Scripting//pipes & CI//

Built for pipes and CI

Every command speaks JSON by default. Auth via SONAR_API_KEY for headless environments.

# Weekly rank report, straight to CSV
sonar export rankings <app-id> --format csv > ranks-$(date +%F).csv

# Gate a release on ASO health in CI (JSON is the default output)
score=$(sonar apps score com.example.app --store android | jq .data.score)
[ "$score" -ge 70 ] || echo "::warning::ASO score dropped to $score"
[ 03 /04 ]·Data//same as the dashboard//

Same data as the dashboard

Real Apple Search Popularity on iOS, calibrated Android estimates, and rankings validated against true store results. See the methodology.

[ 04 /04 ]·FAQ//aso cli//

ASO CLI questions

[ ANSWER ]

What is an ASO CLI?

A command-line tool for App Store Optimization: keyword research, difficulty scores, rank tracking, and competitor analysis from your terminal instead of a web dashboard — pipeable into scripts, cron jobs, and CI pipelines.

Related: the ASO API for direct HTTP access, and the ASO MCP server for AI agents.

npm install and go

Sign up for 50 free credits, grab your API key, and run your first keyword search from the terminal in under a minute.

50 free credits · No subscription · JSON output by default