review-insightslisted
Install: claude install-skill ASOScan/aso-skills
# Review Insights
Turn ASOScan's analyzed review stream into the few things that matter: how users
feel, what they keep asking for, and what's breaking.
## When to use
- "What are users saying about my app?"
- "Top complaints / feature requests / bugs."
- "Summarize the latest reviews." (also for a tracked competitor)
## Calling the ASOScan API
Base `https://asoscan.com/api/public/v1` · header `Authorization: Bearer $ASOSCAN_API_KEY`.
JSON, camelCase. If the key is unset, hand off to **asoscan-setup**.
1. **Find the app** — `GET /apps` → use the `id`. For a rival, it must be a tracked
competitor first (see **competitor-analysis**).
2. **Insights** — `GET /apps/{id}/reviews/insights` (1 credit) →
`{ totalAnalyzed, totalPending, sentiment{ positive, neutral, negative,
averageScore }, topTopics[]{ label, count }, topFeatureRequests[]{ label, count },
topBugs[]{ label, count } }`.
3. **Raw reviews** (for evidence) — `GET /apps/{id}/reviews?page=1&pageSize=20&rating=&sort=newest`
(1 credit; pageSize 1–100; `rating=1..5` to isolate detractors/promoters) →
`{ items[]{ id, author, rating, title, body, version, country, postedAt,
developerResponse, developerResponseAt }, page, pageSize, totalCount, totalPages }`.
Lead with insights; pull raw reviews only to quote real examples. If `totalPending`
is high, note that more reviews are still being analyzed.
## How to analyze
- **Sentiment** — the positive/neutral/negative split + `averageScore` (pair with
th