keyword-opportunitieslisted

# Keyword Opportunities Answer "what should I target next?" with ASOScan's pre-computed, opportunity-scored suggestions — drawn from your metadata, competitors, AI, the category index, and search data — then track the winners, all from real numbers. ## When to use - "What keywords should I add / target?" - "Where are my keyword gaps vs competitors?" - "Suggest high-opportunity keywords for my app." ## 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`. 2. **Opportunities** — `GET /apps/{id}/opportunities?country=&limit=50` (**2 credits**, limit 1–200). Each row: `{ term, volume, difficulty, opportunityScore, competitorRanks[]{ name, rank, isYou } }`. There is **no** "source" field — rank by `opportunityScore` and read `competitorRanks` for context (the entry with `isYou: true` is the owner; `rank: null` there = you don't rank yet). 3. **(Optional) validate a shortlisted term** — the research call in **keyword-intelligence** (8 credits), for a few finalists only. 4. **(Optional) track the picks** — `POST /apps/{id}/keywords` with `{ "terms": [...], "country": "US" }` (**2 credits**, needs a **write** key; up to 500 terms) → `{ added[], skipped[]{ term, reason } }`. ## How to prioritize Sort by `opportunityScore`, then sanity-check each candidate: 1. **Relevant?** Woul