metadata-auditlisted

# Metadata Audit Score the listing with ASOScan's ASO score, find the gaps, and draft better copy — specific, within limits, and honest. ## When to use - "Audit / optimize my app listing." · "What's my ASO score and how do I raise it?" - "Rewrite my title / subtitle / description." · "What metadata changed recently?" ## 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` → note the `id` and `platform` (Apple vs Google — the rules differ). 2. **ASO score (authoritative)** — `GET /apps/{id}/aso-score?country=` (1 credit) → `{ overall, metadata, ratings, conversion, conversionIsProxy, grade, platform, recommendations[]{ category, severity, title, description } }` (0–100; severity `critical|warning|info`). **Use this as the headline number; don't invent one.** 3. **Current metadata** — `GET /apps/{id}/metadata?country=` (1 credit) → `{ title, subtitle, promotionalText, keywords, shortDescription, description, whatsNew, releaseDate }`. A **404** = nothing captured yet. 4. **Change history** — `GET /apps/{id}/metadata/changelog?country=` (1 credit) → `[{ field, oldValue, newValue, changedAt, oldVersion, newVersion }]`. 5. **Target keywords** — pull winners from **keyword-opportunities** / **keyword-intelligence**. ## Platform rules to enforce (Apple/Google official, current) **Apple** — in