sonar
Start free trial

Sonar developer docs

Sonar gives your AI agent live App Store and Google Play data — search popularity, difficulty, true rankings and competitor keywords — through a hosted MCP server, a REST API and a CLI. The facts below are generated from the same settings that bill and limit your account.

At a glance

Hosted MCP server
https://trysonar.app/mcp — streamable HTTP. Sign in through the browser on the first tool call that needs your account; no API key or install.
Claude Code
claude mcp add --transport http sonar https://trysonar.app/mcp
With an API key
claude mcp add sonar -e SONAR_API_KEY=aso_your_key_here -- npx -y @sonarapp/mcp — runs the npm package locally, for scripts, CI and clients without OAuth. Keys start with aso_.
Claude directory
Sonar ASO connector at https://claude.ai/directory/sonar
ChatGPT
The Sonar app in ChatGPT: https://chatgpt.com/plugins/plugin_asdk_app_6ab4efdf6b2081918af783da376edf18 — connect it and sign in with your Sonar account, no API key. It runs on https://trysonar.app/mcp/chatgpt.
MCP tools
63 tools covering the whole REST API (62 on the hosted endpoint — exporting screenshots to disk is local-only).
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
Free tier
No account or key: 7 stateless endpoints (app lookup, app search, ASO score, keyword extraction, keyword suggestions, keyword metrics and top charts). 30 requests/day per IP shared, and keyword metrics allows 5 keywords/day per IP.
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
Free trial
7 days on Indie or Agency, card required, $0 today, cancel anytime. The API allows 150 requests/day during the trial. Credit packs start at $10 with no trial needed.
Stores and countries
App Store (175 storefronts) and Google Play (145 markets) for app lookup, search, reviews and ASO scores. Keyword research and rank tracking cover 72 markets.
Data freshness
Tracked keywords are re-ranked once per UTC day; iOS ranks follow Apple's own App Store search order. iOS popularity is Apple's Search Popularity where Apple reports it, with a calibrated estimate below Apple's floor.
Support
https://trysonar.app/support · [email protected]

Guides

  • MCP server

    Hosted endpoint or the npm package, all 63 tools, per-client setup.

  • REST API reference

    Every endpoint with parameters, responses, errors, credit costs and rate limits.

  • Authentication

    API keys, OAuth access tokens and the keyless free tier.

  • CLI

    The sonar command for terminals, scripts and CI.

  • Connect your agent

    Step-by-step setup for Claude Code, Codex, Cursor, Claude and ChatGPT.

Machine-readable resources