Skip to main content

​
Quick Start

This guide walks you through registering for an API key, fetching app metadata, pulling an intelligence report, and exploring keyword data — all in five steps.
Base URL for all requests: https://api.appeeky.com
1

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. The key is stored as a SHA-256 hash and cannot be retrieved later. You can regenerate a new key from the dashboard at any time.
For the remaining steps, replace YOUR_API_KEY with the key you received.
2

Make Your First Request

Fetch metadata for Block Blast! (App ID 1617391485). This returns the full iTunes Lookup data: title, developer, screenshots, version, ratings, and more.
curl "https://api.appeeky.com/v1/apps/1617391485?country=us" \
  -H "X-API-Key: YOUR_API_KEY"
Response (200 OK):
{
  "data": {
    "trackId": 1617391485,
    "trackName": "Block Blast!",
    "sellerName": "Hungry Studio",
    "bundleId": "com.hungrystudio.blockblast",
    "primaryGenreName": "Games",
    "averageUserRating": 4.7,
    "userRatingCount": 892451,
    "price": 0,
    "currentVersionReleaseDate": "2025-12-10T08:00:00Z",
    "artworkUrl512": "https://is1-ssl.mzstatic.com/image/...",
    "screenshotUrls": ["https://is1-ssl.mzstatic.com/image/..."],
    "description": "Block Blast is an addictive puzzle game..."
  }
}
Use the country query parameter to get localized metadata. Default is us. Common values: us, gb, de, jp, fr, kr, br.
3

Get an Intelligence Report

The intelligence endpoint returns market estimates (downloads, revenue), in-app purchases, similar apps, and sentiment analysis — all in a single call.
curl "https://api.appeeky.com/v1/apps/1617391485/intelligence?country=us" \
  -H "X-API-Key: YOUR_API_KEY"
Response (200 OK):
{
  "data": {
    "trackId": 1617391485,
    "trackName": "Block Blast!",
    "marketIntelligence": {
      "estimatedDownloads": {
        "value": 4200000,
        "range": { "low": 3100000, "high": 5600000 },
        "confidence": "high",
        "period": "monthly"
      },
      "estimatedRevenue": {
        "value": 8900000,
        "range": { "low": 6200000, "high": 12000000 },
        "confidence": "high",
        "period": "monthly",
        "currency": "USD"
      }
    },
    "inAppPurchases": [
      { "name": "Remove Ads", "price": "$4.99" },
      { "name": "Weekly VIP", "price": "$7.99" },
      { "name": "1000 Coins", "price": "$1.99" }
    ],
    "similarApps": [
      { "trackId": 1580819864, "trackName": "Hexa Sort", "sellerName": "Lion Studios" },
      { "trackId": 1594113349, "trackName": "Royal Match", "sellerName": "Dream Games" },
      { "trackId": 553834731, "trackName": "Candy Crush Saga", "sellerName": "King" }
    ],
    "sentimentAnalysis": {
      "averageRating": 4.7,
      "totalReviews": 892451,
      "positivePercentage": 89.2,
      "topPositiveThemes": ["addictive gameplay", "simple controls", "relaxing"],
      "topNegativeThemes": ["too many ads", "difficulty spikes"]
    }
  }
}
The intelligence endpoint costs 5 credits because it aggregates data from multiple sources in parallel. Use /v1/apps/:id (2 credits) if you only need basic metadata.
4

Explore Keywords

See which apps rank for a specific keyword, along with popularity and competitiveness scores.
curl "https://api.appeeky.com/v1/keywords/ranks?keyword=puzzle+game&country=us" \
  -H "X-API-Key: YOUR_API_KEY"
Response (200 OK):
{
  "data": {
    "keyword": "puzzle game",
    "country": "us",
    "popularity": 62,
    "competitiveness": 78,
    "totalResults": 200,
    "rankings": [
      { "rank": 1, "trackId": 1617391485, "trackName": "Block Blast!", "sellerName": "Hungry Studio" },
      { "rank": 2, "trackId": 1594113349, "trackName": "Royal Match", "sellerName": "Dream Games" },
      { "rank": 3, "trackId": 553834731, "trackName": "Candy Crush Saga", "sellerName": "King" },
      { "rank": 4, "trackId": 913335252, "trackName": "Brilliant", "sellerName": "Brilliant.org" },
      { "rank": 5, "trackId": 1580819864, "trackName": "Hexa Sort", "sellerName": "Lion Studios" }
    ]
  }
}
5

Track a Keyword

Add a keyword to the daily scraping pipeline so rank data stays fresh.
curl -X POST https://api.appeeky.com/v1/keywords/track \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"keyword": "puzzle game", "country": "us"}'
Response (200 OK):
{
  "data": {
    "keyword": "puzzle game",
    "country": "us",
    "status": "tracked",
    "message": "Keyword is now being tracked. Rankings will be updated daily."
  }
}
Tracked keywords are scraped daily. Historical rank data becomes available through the /v1/apps/:id/keywords/trends endpoint after the first scrape cycle.

​
Next Steps

You’ve covered the basics. Dive deeper into specific areas:

App Metadata

Full app details, screenshots, and version history

Intelligence Reports

Revenue estimates, downloads, IAPs, and competitor analysis

Keyword Rankings

See which apps rank for any keyword

App Keywords

Discover all keywords an app ranks for

Search Apps

Search the App Store by keyword or ID

Category Charts

Top apps by category, chart type, and country

Rate Limits

Credit costs, plans, and usage tracking

API Overview

Complete endpoint reference and error codes