Skip to main content
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

Sign up with email or GitHub — your API key is generated instantly.
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. 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"

​
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"
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"
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

Use the Appeeky Dashboard to manage your API key, view usage, and upgrade your plan:
ActionWhere
View & copy API keyDashboard
Regenerate API keyDashboard
View usage breakdownUsage
Upgrade or manage planBilling

​
Error Responses

StatusCodeWhen
401MISSING_API_KEYNo API key provided in request headers
401INVALID_API_KEYKey is invalid, inactive, or revoked
429RATE_LIMIT_EXCEEDEDMonthly 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."
  }
}