FAQ
Frequently asked questions about ASORadar — App Reviews API for App Store and Google Play. Coverage, billing, integration, limits.
Frequently asked questions
Which stores do you support?
Both Apple App Store (/a1) and Google Play (/g1) with a unified JSON format: reviews, app metadata, search, top charts, similar apps, developer portfolios, ratings, privacy / Data Safety, and version history. Any public storefront country, with rating, date-range, language, and full-text filters on reviews.
How do I get an API key? Is there a free tier?
Create an account — every new account gets 100 free requests, no credit card required. Keys live in the dashboard under Tokens; you can create several and revoke them independently.
How does pricing work?
Pay-per-request from $0.001 per request. Top up your balance and spend it at your own pace — no subscription, no monthly minimum.
Which requests am I charged for?
Only definitive answers: responses with status 200, 400, 403, 404. Auth errors (401), out-of-budget (402), validation errors (422), rate-limit hits (429) and 5xx are free. Composite AI-agent endpoints fan out several internal calls and are billed as that number of requests.
Will my funds expire?
No. Your balance never expires — if you stop making requests, it just sits there until you come back.
How do I authenticate?
Send your key in the x-access-key header (recommended) or as an access_key query parameter. Both work on every endpoint.
Is there a rate limit?
Yes — 10 requests/second on the default plan (plan-dependent). Exceeding it returns 429 with a Retry-After header, and those hits are not billed.
How fresh is the data? Can I force a live fetch?
Reads are cache-first: metadata responses carry cached and fetched_at, and stale review caches refresh transparently during your request. Pass fresh=true on any cache-eligible endpoint to force a realtime fetch from the store.
Do you have SDKs?
Yes — official, typed, generated from the OpenAPI spec: JavaScript/TypeScript (npm install asoradar) and Python (pip install asoradar, sync + async). The REST API also works fine without any SDK.
Can AI assistants like Claude or Cursor use ASORadar?
Yes — run `npx -y asoradar-mcp` and every endpoint becomes an MCP tool in Claude, Cursor, Codex, Zed, or Windsurf. Same key, same pricing.
Do you support webhooks?
Yes — subscribe to app changes, chart movement, or review keywords. Deliveries are HMAC-signed HTTPS POSTs with retries. Manage subscriptions in the dashboard or via POST /webhooks.
Can you classify review sentiment?
Yes — GET /a1/reviews/sentiment/{app_id} (and /g1/…) returns LLM-classified sentiment in four classes with topic clusters, aggregated over the cached reviews.
Do you have an enterprise plan?
Yes — write to us by email or Telegram for custom pricing, higher rate limits, SLA guarantees, and dedicated support.