Command-line tool · App Store and Google Play

The ASO CLI for your terminal.

Keyword difficulty, search popularity, rankings and competitor analysis as shell commands. Pipe it, script it, run it in CI.

Get an API key CLI docs

50 free credits on signup · No subscription · JSON by default

Terminal

$ npm install -g @sonarapp/cli
$ export SONAR_API_KEY=aso_…
$ sonar keywords metrics "habit tracker" "habit tracker app" \
    "daily routine planner" --store ios --table

KeywordStoreCountryDifficultyPopularityResults

habit trackeriOSus

200

habit tracker appiOSus

~200

daily routine planneriOSus

beatable

~200

3 keywords · 3 credits charged

At a glance

npm packages: @sonarapp/[email protected] (MCP server) · @sonarapp/[email protected] (CLI, binary sonar)
CLI install: npm install -g @sonarapp/cli then sonar auth login
REST API: https://trysonar.app/api/v1 — Bearer aso_… API key or an OAuth access token. OpenAPI 3.1 spec: https://trysonar.app/openapi.json
API credits: 50 free credits on signup. Prepaid packs, no subscription, credits never expire: $10 / 1,000 credits · $20 / 2,500 credits · $50 / 7,000 credits · $100 / 15,000 credits.
Credit costs: 1 credit per call for app lookup, app search, keyword suggestions, keyword extraction, ASO score, reviews and top charts · 10 credits per call for keyword research · 1 credit per app for revenue estimates · 1 credit per keyword for keyword metrics. Failed calls are free.
Indie plan: $29/month or $290/year · 10 apps · 2,500 tracked keywords · competitors uncapped · 1 seat · 1,000 API requests/day
Agency plan: $149/month or $1,490/year · 50 apps · 10,000 tracked keywords · competitors uncapped · 5 seats · 5,000 API requests/day · portfolio rollup, white-label client reports, App Store Connect data via the API
Support: https://trysonar.app/support · [email protected]

Commands

The whole ASO workflow, one binary

Command	What it does
sonar keywords search	A seed keyword plus related ideas
sonar keywords metrics	Difficulty and popularity for up to 25 keywords
sonar keywords suggestions	Store autocomplete suggestions
sonar apps search	Find apps by keyword
sonar apps lookup	Listing metadata for any app
sonar apps score	ASO audit score (0–100) for any app
sonar rankings	Daily rank history for your tracked apps
sonar competitors keywords	Competitor keywords and gaps
sonar revenue	Monthly revenue estimate for any app
sonar export rankings	Rank history as CSV or JSON

Every command and flag

Scripting

Built for pipes and CI

Gate a release
```
sonar apps score com.example.app \
  --store android | jq .data.score
```
JSON by default
Pipe it anywhere; add --table when a person is reading.
CI and cron
```
export SONAR_API_KEY=aso_…
```
Headless auth
Set SONAR_API_KEY in CI or cron and skip the login step.
Weekly report
```
sonar export rankings <app-id> \
  --format csv > ranks.csv
```
CSV export
Rank history as CSV or JSON for sheets and reports.

Same data as the dashboard, Apple's own search popularity included. See the methodology

FAQ

ASO CLI questions

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.

Run npm install -g @sonarapp/cli, then sonar auth login with your API key, or set the SONAR_API_KEY environment variable. It's a standalone Node.js binary published on npm.

Yes. JSON is the default output (add --table for human-readable tables), and auth works through the SONAR_API_KEY environment variable. Common uses: pre-release ASO checks in CI, scheduled rank exports and keyword monitoring cron jobs.

Yes. Commands take --store ios or android, and the research commands take a --country code. Difficulty, popularity, rankings, reviews and revenue estimates work for both stores.

The CLI is free on npm; it talks to the Sonar API. Sign up for 50 free credits, then prepaid packs from $10 (no subscription), or the Indie plan at $29/mo with 1,000 req/day and daily rank tracking.

What is an ASO CLI?

npm install and go

Start free trial CLI docs

7-day free trial · Card required, $0 today · Cancel anytime

Prefer HTTP or an agent? The ASO API and ASO MCP server use the same data.