{
  "info": {
    "name": "ASOScan Public API (v1)",
    "description": "Read + write the ASO data you track on ASOScan. Set the `apiKey` collection variable to a key you minted in Settings → API access (asosk_live_…). Business plan and above. Docs: https://asoscan.com/developers",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
  },
  "auth": {
    "type": "bearer",
    "bearer": [{ "key": "token", "value": "{{apiKey}}", "type": "string" }]
  },
  "variable": [
    { "key": "baseUrl", "value": "https://asoscan.com/api/public/v1", "type": "string" },
    { "key": "apiKey", "value": "asosk_live_REPLACE_ME", "type": "string" },
    { "key": "appId", "value": "00000000-0000-0000-0000-000000000000", "type": "string" }
  ],
  "item": [
    {
      "name": "Read",
      "item": [
        { "name": "List apps", "request": { "method": "GET", "url": { "raw": "{{baseUrl}}/apps", "host": ["{{baseUrl}}"], "path": ["apps"] } } },
        { "name": "Get app", "request": { "method": "GET", "url": { "raw": "{{baseUrl}}/apps/{{appId}}", "host": ["{{baseUrl}}"], "path": ["apps", "{{appId}}"] } } },
        { "name": "Tracked keywords", "request": { "method": "GET", "url": { "raw": "{{baseUrl}}/apps/{{appId}}/keywords?country=US&rankWindow=7d", "host": ["{{baseUrl}}"], "path": ["apps", "{{appId}}", "keywords"], "query": [{ "key": "country", "value": "US" }, { "key": "rankWindow", "value": "7d" }] } } },
        { "name": "ASO score", "request": { "method": "GET", "url": { "raw": "{{baseUrl}}/apps/{{appId}}/aso-score?country=US", "host": ["{{baseUrl}}"], "path": ["apps", "{{appId}}", "aso-score"], "query": [{ "key": "country", "value": "US" }] } } },
        { "name": "Opportunities", "request": { "method": "GET", "url": { "raw": "{{baseUrl}}/apps/{{appId}}/opportunities?country=US&limit=50", "host": ["{{baseUrl}}"], "path": ["apps", "{{appId}}", "opportunities"], "query": [{ "key": "country", "value": "US" }, { "key": "limit", "value": "50" }] } } },
        { "name": "Competitors", "request": { "method": "GET", "url": { "raw": "{{baseUrl}}/apps/{{appId}}/competitors?country=US", "host": ["{{baseUrl}}"], "path": ["apps", "{{appId}}", "competitors"], "query": [{ "key": "country", "value": "US" }] } } },
        { "name": "Keyword research (live)", "request": { "method": "GET", "url": { "raw": "{{baseUrl}}/apps/{{appId}}/keywords/research?term=habit%20tracker&country=US", "host": ["{{baseUrl}}"], "path": ["apps", "{{appId}}", "keywords", "research"], "query": [{ "key": "term", "value": "habit tracker" }, { "key": "country", "value": "US" }] } } },
        { "name": "Usage (free)", "request": { "method": "GET", "url": { "raw": "{{baseUrl}}/usage", "host": ["{{baseUrl}}"], "path": ["usage"] } } }
      ]
    },
    {
      "name": "Write (requires a write-scoped key)",
      "item": [
        { "name": "Add keywords", "request": { "method": "POST", "header": [{ "key": "Content-Type", "value": "application/json" }], "body": { "mode": "raw", "raw": "{\n  \"terms\": [\"habit tracker\", \"daily planner\"],\n  \"country\": \"US\"\n}" }, "url": { "raw": "{{baseUrl}}/apps/{{appId}}/keywords", "host": ["{{baseUrl}}"], "path": ["apps", "{{appId}}", "keywords"] } } },
        { "name": "Add competitor", "request": { "method": "POST", "header": [{ "key": "Content-Type", "value": "application/json" }], "body": { "mode": "raw", "raw": "{\n  \"storeUrl\": \"https://apps.apple.com/us/app/id123456789\"\n}" }, "url": { "raw": "{{baseUrl}}/apps/{{appId}}/competitors", "host": ["{{baseUrl}}"], "path": ["apps", "{{appId}}", "competitors"] } } }
      ]
    }
  ]
}