curl --request GET \
  --url https://api.appgoat.ai/v1/keywords \
  --header 'x-api-key: <api-key>'

const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};

fetch('https://api.appgoat.ai/v1/keywords', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.appgoat.ai/v1/keywords"

headers = {"x-api-key": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)

{
  "data": [
    {
      "term": "photo editor",
      "store": "apple",
      "country": "us",
      "popularity": 62,
      "popularity_source": "proxy",
      "difficulty": 81,
      "results_count": 200,
      "est_downloads_at_1": 2900,
      "measured_at": "2026-10-20T10:00:00Z",
      "pending": false,
      "top_app_ids": [
        "1",
        "2"
      ],
      "app": {
        "store": "apple",
        "app_id": "1",
        "rank": 14,
        "relevance": 1
      }
    }
  ],
  "meta": {
    "credits_used": 1,
    "store": "apple"
  }
}

{
  "error": {
    "code": "invalid_param",
    "message": "limit must be ≤ 100",
    "hint": "Fix the parameter and retry.",
    "docs": "https://appgoat.ai/docs/errors#invalid_param",
    "param": "limit"
  }
}

{
  "error": {
    "code": "invalid_param",
    "message": "<string>",
    "hint": "<string>",
    "docs": "<string>",
    "param": "<string>"
  }
}