Skip to main content
Base URL: https://api.appeeky.com All endpoints are versioned under /v1. Authentication is required for all endpoints except /v1/health.

​
Endpoints

​
Health & Auth

MethodEndpointDescriptionCredits
GET/v1/healthService health check0
GET/v1/auth/usageCheck your credit usage0

​
Apps

MethodEndpointDescriptionCredits
GET/v1/apps/:idFull app metadata (iTunes Lookup)2
GET/v1/apps/:id/intelligenceIntelligence report: revenue, downloads, IAPs, similar apps, sentiment5
GET/v1/apps/:id/reviewsUser reviews from Apple RSS (up to 500)2
GET/v1/apps/:id/keywordsAll organic keyword rankings for an app3
GET/v1/apps/:id/keywords/trendsHistorical rank trend for a keyword2
GET/v1/apps/:id/country-rankingsApp’s chart positions across countries3

​
Screenshots

MethodEndpointDescriptionCredits
GET/v1/apps/:id/screenshotsAll screenshots for an app, split by device (iPhone/iPad)2
GET/v1/apps/:id/screenshots/competitorsCompare screenshots between an app and its competitors3
GET/v1/categories/:genreId/top/screenshotsScreenshots for top apps in a category3

​
Keywords

MethodEndpointDescriptionCredits
GET/v1/keywords/ranksApps ranking for a specific keyword2
GET/v1/keywords/suggestionsApple Search autocomplete suggestions1
GET/v1/keywords/metricsSearch volume and difficulty for a keyword2
GET/v1/keywords/compareCompetitor keyword overlap and gap analysis3
GET/v1/keywords/trendingKeywords with fastest-growing reach2
POST/v1/keywords/trackAdd keyword to the daily scraping pipeline1

​
Search & Discovery

MethodEndpointDescriptionCredits
GET/v1/searchSearch apps by keyword or App ID1
GET/v1/categoriesList all App Store categories1
GET/v1/categories/:id/topTop Free / Top Paid / Top Grossing per category2
GET/v1/categories/:id/downloads-to-topEstimated downloads to reach chart positions2
GET/v1/featuredApps featured on the App Store Today tab3
GET/v1/new-releasesRecently released apps from Apple RSS2
GET/v1/discoverTrending and noteworthy apps2
GET/v1/discover/new-number-1Apps that just reached #1 in their category2

​
Response Format

​
Success

All successful responses wrap data in a data envelope: 
{
  "data": {
    "trackId": 1617391485,
    "trackName": "Block Blast!",
    "sellerName": "Hungry Studio",
    "primaryGenreName": "Games",
    "averageUserRating": 4.7,
    "price": 0
  }
}

​
Error

Errors return an error object containing a machine-readable code and a human-readable message: 
{
  "error": {
    "code": "INVALID_APP_ID",
    "message": "App ID must be a positive integer"
  }
}

​
Error Codes

​
Client Errors (4xx)

StatusCodeDescription
400INVALID_APP_IDApp ID is missing or not a positive integer
400INVALID_QUERYSearch query is too short (min 2 characters)
400INVALID_KEYWORDKeyword is missing or too short (min 2 characters)
400INVALID_COUNTRYCountry code is not a valid ISO 3166-1 alpha-2 code
400INVALID_GENRE_IDGenre ID is not valid
400INVALID_SORTSort parameter is not one of the allowed values
400MISSING_PARAMETERA required parameter is missing
401MISSING_API_KEYNo API key provided in request headers
401INVALID_API_KEYAPI key is invalid, inactive, or revoked
404APP_NOT_FOUNDApp does not exist or is unavailable in the specified country
404KEYWORD_NOT_FOUNDNo ranking data available for this keyword
409EMAIL_ALREADY_REGISTEREDEmail address already has an active API key
429RATE_LIMIT_EXCEEDEDMonthly credit limit has been reached

​
Server Errors (5xx)

StatusCodeDescription
500INTERNAL_ERRORUnexpected server error
500DB_ERRORDatabase operation failed
502UPSTREAM_ERRORApple API or upstream service returned an error
503SERVICE_UNAVAILABLEService temporarily unavailable (maintenance)
504UPSTREAM_TIMEOUTApple API or upstream service timed out
All error responses include the error.code field, which is stable and safe to use for programmatic error handling. The error.message field is human-readable and may change.

​
Pagination

Endpoints that return lists support pagination via query parameters:
ParameterTypeDefaultDescription
limitinteger25Number of results to return (max varies by endpoint)
offsetinteger0Number of results to skip
Example: 
GET /v1/apps/1617391485/reviews?country=us&limit=10&offset=20
Paginated responses include a pagination object when applicable: 
{
  "data": {
    "reviews": [ ... ],
    "pagination": {
      "limit": 10,
      "offset": 20,
      "total": 487,
      "hasMore": true
    }
  }
}
FieldTypeDescription
limitintegerNumber of results returned
offsetintegerCurrent offset
totalintegerTotal number of results available
hasMorebooleanWhether there are more results to fetch

​
Country Codes

Many endpoints accept a country query parameter using ISO 3166-1 alpha-2 codes. If omitted, the default is us.

​
Common Country Codes

CodeCountryCodeCountry
usUnited StatesjpJapan
gbUnited KingdomkrSouth Korea
deGermanycnChina
frFrancebrBrazil
itItalyinIndia
esSpainauAustralia
caCanadamxMexico
nlNetherlandstrTurkey
seSwedensaSaudi Arabia
ruRussiaidIndonesia
The full list includes all countries where the iOS App Store is available (175+ storefronts). Use the two-letter ISO 3166-1 alpha-2 country code in lowercase.

​
HTTP Status Codes

StatusMeaningWhen
200OKRequest succeeded
201CreatedResource successfully created (e.g., API key registration)
400Bad RequestInvalid parameters, missing required fields
401UnauthorizedMissing or invalid API key
404Not FoundApp, keyword, or resource not found
409ConflictDuplicate resource (e.g., email already registered)
429Too Many RequestsMonthly credit limit exceeded
500Internal Server ErrorUnexpected server failure
502Bad GatewayUpstream service error
503Service UnavailableTemporary maintenance
504Gateway TimeoutUpstream service timeout

​
Key Features

  • App Metadata — Complete iTunes Lookup data including description, screenshots, version, size, languages, and age rating
  • In-App Purchases — Subscription and IAP names with prices, scraped directly from the App Store product page
  • Market Intelligence — Estimated downloads and revenue using power-law models with confidence levels and ranges
  • Similar Apps — Competitors via 3-layer matching: keyword overlap, title search + genre filter, and same developer
  • Category Charts — Top Free, Top Paid, and Top Grossing per category with genre filtering
  • Downloads to Top — Estimated daily downloads needed to reach specific chart positions per category
  • Keyword Intelligence — Volume scoring, difficulty analysis, competitor overlap, autocomplete suggestions, and rank trends
  • User Reviews — Customer reviews from Apple RSS with sorting and pagination (up to 500 per country)
  • App Search — Keyword search or direct App ID lookup via the iTunes Search API
  • Country Rankings — Track an app’s chart positions across multiple countries simultaneously
  • Featured Apps — App of the Day, Game of the Day, and curated editorial collections from the App Store Today tab
  • Trending Keywords — Keywords with the fastest-growing reach, ranked by growth percentage
  • Discovery — New releases, trending apps, and apps that just hit #1 in their category