competitor-analysislisted
Install: claude install-skill ASOScan/aso-skills
# Competitor Analysis
Position the app against the rivals ASOScan tracks — where it's ahead, where it's
behind, and the single biggest lever — using real rank, rating, and keyword data.
## When to use
- "Compare my app to my competitors."
- "Add `<store URL>` as a competitor."
- "What category do my competitors use / how's my category rank vs theirs?"
## 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` → `{ id, name, category, rating, … }` (your own
`category` is here).
2. **Competitors** — `GET /apps/{id}/competitors?country=` (1 credit) →
`[{ id, name, developer, iconUrl, rating, ratingCount, category }]`. The
`category` is each competitor's **primary store category** — this answers "what
category do my competitors use?" (only the primary is exposed, not Apple's
secondary).
3. **Add a rival** (if asked) — `POST /apps/{id}/competitors { "storeUrl": "…" }`
(2 credits, **write** key). Confirm before writing.
4. **Category rank over time** — `GET /apps/{id}/category-rank?country=&days=30`
(1 credit) → `{ category, country, rankType, currentRank, points[]{ date, rank } }`.
5. **Rating trajectory** — `GET /apps/{id}/rating-history` (1 credit) →
`[{ rating, totalRatings, date }]`.
6. **Keyword overlap** — pair with **keyword-spy** on each competitor for the gap list.
Category-rank an