Skip to main content

Get your API key

1

Create an account

Sign up at appkittie.com and choose a plan that includes API access.
2

Generate an API key

Navigate to Settings → API Keys in your dashboard and click Create API Key. Give it a descriptive name.
Copy your API key immediately — it won’t be shown again.
3

Make your first request

Use your API key in the Authorization header as a Bearer token:
curl -X GET "https://appkittie.com/api/v1/apps?search=fitness&limit=5" \
  -H "Authorization: Bearer YOUR_API_KEY"

Example Responses

Search for apps

curl -X GET "https://appkittie.com/api/v1/apps?search=meditation&categories=Health+%26+Fitness&minRating=4&limit=3" \
  -H "Authorization: Bearer YOUR_API_KEY"
{
  "data": [
    {
      "app_slug": "calm-meditation",
      "icon": "https://...",
      "title": "Calm - Meditation & Sleep",
      "developer": "Calm.com, Inc.",
      "primary_genre": "Health & Fitness",
      "score": 4.8,
      "reviews": 1250000,
      "url": "https://apps.apple.com/...",
      "downloads": 85000,
      "historical_counts": { "revenue_last_30d": 4200000 }
    }
  ],
  "pagination": {
    "nextCursor": 3,
    "totalCount": 1847
  }
}

Check keyword difficulty

curl -X GET "https://appkittie.com/api/v1/keywords/difficulty?keyword=meditation&country=US" \
  -H "Authorization: Bearer YOUR_API_KEY"
{
  "data": {
    "keyword": "meditation",
    "country": "US",
    "popularity": 62,
    "difficulty": 85,
    "appsCount": 245,
    "trafficScore": 71,
    "topApps": [
      {
        "appStoreId": "571800810",
        "title": "Calm",
        "icon": "https://...",
        "developer": "Calm.com, Inc.",
        "reviews": 1250000,
        "score": 4.8,
        "rank": 1
      }
    ]
  }
}

Response Headers

Every API response includes these custom headers:
HeaderDescription
X-RateLimit-LimitMax requests per minute
X-RateLimit-RemainingRequests remaining in current window
X-RateLimit-ResetUnix timestamp when the window resets
X-Credits-UsedCredits consumed by this request
X-Credits-RemainingYour remaining credit balance

Next Steps

Authentication

Deep dive into auth and security.

Credits System

Understand how credits work and are billed.

List Apps

Search and filter 2M+ apps.

Keyword Difficulty

Analyze keyword competition.