Authentication

All API endpoints (except /v1/health) require authentication. The Appeeky API uses API keys to identify and authorize requests.

Get Your API Key

Create a free account on the Appeeky Dashboard to get your API key with 100 monthly credits:

Create Your Account

Save your API key immediately. It is displayed only once during creation. The key is stored as a SHA-256 hash in our database and cannot be retrieved later. You can regenerate a new key from the dashboard at any time.

Authentication Methods

The API supports two ways to pass your API key.

Method 1: X-API-Key Header (Recommended)

Pass the key in the X-API-Key header:

curl "https://api.appeeky.com/v1/apps/1617391485?country=us" \
  -H "X-API-Key: apk_a1b2c3d4e5f6789012345678abcdef90abcdef1234567890abcdef1234567890ab"

const res = await fetch(
  "https://api.appeeky.com/v1/apps/1617391485?country=us",
  {
    headers: {
      "X-API-Key": "apk_a1b2c3d4e5f6789012345678abcdef90abcdef1234567890abcdef1234567890ab",
    },
  }
);
const { data } = await res.json();

import requests

res = requests.get(
    "https://api.appeeky.com/v1/apps/1617391485",
    params={"country": "us"},
    headers={"X-API-Key": "apk_a1b2c3d4e5f6789012345678abcdef90abcdef1234567890abcdef1234567890ab"},
)
data = res.json()["data"]

Method 2: Authorization Bearer Header

Alternatively, use the standard Authorization: Bearer header:

curl "https://api.appeeky.com/v1/apps/1617391485?country=us" \
  -H "Authorization: Bearer apk_a1b2c3d4e5f6789012345678abcdef90abcdef1234567890abcdef1234567890ab"

const res = await fetch(
  "https://api.appeeky.com/v1/apps/1617391485?country=us",
  {
    headers: {
      Authorization: "Bearer apk_a1b2c3d4e5f6789012345678abcdef90abcdef1234567890abcdef1234567890ab",
    },
  }
);
const { data } = await res.json();

import requests

res = requests.get(
    "https://api.appeeky.com/v1/apps/1617391485",
    params={"country": "us"},
    headers={"Authorization": "Bearer apk_a1b2c3d4e5f6789012345678abcdef90abcdef1234567890abcdef1234567890ab"},
)
data = res.json()["data"]

Both methods are equivalent. Use whichever fits your HTTP client or framework. If both headers are present, X-API-Key takes priority.

Check Your Usage

Monitor your credit consumption via the API or the dashboard:

curl "https://api.appeeky.com/v1/auth/usage" \
  -H "X-API-Key: YOUR_API_KEY"

const res = await fetch("https://api.appeeky.com/v1/auth/usage", {
  headers: { "X-API-Key": "YOUR_API_KEY" },
});
const { data } = await res.json();
console.log(`${data.used}/${data.monthlyCredits} credits used`);

import requests

res = requests.get(
    "https://api.appeeky.com/v1/auth/usage",
    headers={"X-API-Key": "YOUR_API_KEY"},
)
data = res.json()["data"]
print(f'{data["used"]}/{data["monthlyCredits"]} credits used')

Response (200 OK):

{
  "data": {
    "plan": "free",
    "monthlyCredits": 100,
    "used": 47,
    "remaining": 53,
    "resetDate": "2026-03-01T00:00:00.000Z",
    "usageByEndpoint": [
      { "endpoint": "GET /apps/:id", "totalCredits": 20, "requestCount": 10 },
      { "endpoint": "GET /apps/:id/intelligence", "totalCredits": 25, "requestCount": 5 },
      { "endpoint": "GET /search", "totalCredits": 2, "requestCount": 2 }
    ]
  }
}

Manage Your Account

API keys and usage live on the API dashboard. Billing depends on which track you are on — web and API-only are separate. See Rate Limits & Credits.

Action	Where
View & copy API key	API dashboard
Regenerate API key	API dashboard
View usage breakdown	Usage
Web plan or extra credits (appeeky.com)	Settings → Subscription
API-only plan (Starter / Growth / Pro / Enterprise)	API billing

Error Responses

Status	Code	When
401	`MISSING_API_KEY`	No API key provided in request headers
401	`INVALID_API_KEY`	Key is invalid, inactive, or revoked
429	`RATE_LIMIT_EXCEEDED`	Monthly credit limit reached

Example error response:

{
  "error": {
    "code": "MISSING_API_KEY",
    "message": "API key is required. Pass it in the X-API-Key header or Authorization: Bearer header."
  }
}

Getting Started

Apps

My Data - Appeeky Web

Keywords

ASO Tools

AI Visibility

Search & Discovery

Market Intelligence

RevenueCat

Superwall

App Store Connect

Google Play Console

Apple Search Ads

Growth Channels

Reference

Get Your API Key

Create Your Account

Authentication Methods

Method 1: X-API-Key Header (Recommended)

Method 2: Authorization Bearer Header

Check Your Usage

Manage Your Account

Error Responses

​Get Your API Key

Create Your Account

​Authentication Methods

​Method 1: X-API-Key Header (Recommended)

​Method 2: Authorization Bearer Header

​Check Your Usage

​Manage Your Account

​Error Responses

Get Your API Key

Authentication Methods

Method 1: X-API-Key Header (Recommended)

Method 2: Authorization Bearer Header

Check Your Usage

Manage Your Account

Error Responses