Skip to main content

​
Base URL

All API requests are made to: 
https://appkittie.com/api/v1

​
Authentication

Every request must include a Bearer token in the Authorization header: 
Authorization: Bearer YOUR_API_KEY
Generate API keys from your dashboard. See Authentication for details.

​
Available Endpoints

List Apps

GET /api/v1/appsSearch, filter, and sort across 2M+ iOS apps. Supports 30+ filter dimensions.

Get App Details

GET /api/v1/apps/:appIdRetrieve full details for a single app, including historical data, ad creatives, contacts, and in-app purchases.

Keyword Difficulty

GET /api/v1/keywords/difficultyAnalyze difficulty and opportunity for a single keyword in any supported country.

Batch Keywords

POST /api/v1/keywords/difficultyAnalyze up to 10 keywords in a single request, sorted by opportunity score.

​
Response Format

All successful responses wrap data in a data field: 
{
  "data": { ... }
}
List endpoints include a pagination object: 
{
  "data": [ ... ],
  "pagination": {
    "nextCursor": 50,
    "totalCount": 12450
  }
}
Error responses include an error field: 
{
  "error": "Description of what went wrong"
}

​
Common Headers

​
Request Headers

HeaderRequiredDescription
AuthorizationYesBearer YOUR_API_KEY
Content-TypePOST onlyapplication/json

​
Response Headers

HeaderDescription
X-RateLimit-LimitMax requests per 60-second window
X-RateLimit-RemainingRequests remaining in current window
X-RateLimit-ResetUnix timestamp when window resets
X-Credits-UsedCredits consumed by this request
X-Credits-RemainingYour remaining credit balance

​
Pagination

List endpoints use cursor-based pagination. The nextCursor value from the response should be passed as the cursor query parameter on the next request. 
# First page
curl "https://appkittie.com/api/v1/apps?limit=50"

# Next page
curl "https://appkittie.com/api/v1/apps?limit=50&cursor=50"
When nextCursor is null or absent, there are no more results.