Get App Intelligence

GET /v1/apps/:id/intelligence

Full app intelligence report including metadata, market estimates (downloads and revenue), in-app purchases, and sentiment analysis. This is the most comprehensive endpoint for analyzing any iOS app.

Similar apps have moved to a dedicated endpoint. Use GET /v1/apps/:id/similar to fetch similar apps separately. The intelligence endpoint now returns similarApps: [] by default.

Path Parameters

Name	Type	Required	Description
id	string	Yes	App ID — numeric for Apple (`913335252`), package name for Google (`com.spotify.music`)

Query Parameters

Name	Type	Default	Description
platform	string	`apple`	`apple` (default) or `google` for Google Play — see Platforms
country	string	`us`	ISO country code (e.g. `us`, `gb`, `de`)
lang	string	`en`	Google Play language code (used when `platform=google`)

Code Examples

curl -X GET "https://api.appeeky.com/v1/apps/913335252/intelligence?country=us" \
  -H "X-API-Key: YOUR_API_KEY"

const response = await fetch(
  "https://api.appeeky.com/v1/apps/913335252/intelligence?country=us",
  {
    headers: {
      "X-API-Key": "YOUR_API_KEY",
    },
  }
);

const data = await response.json();
console.log(data);

import requests

response = requests.get(
    "https://api.appeeky.com/v1/apps/913335252/intelligence",
    params={"country": "us"},
    headers={"X-API-Key": "YOUR_API_KEY"},
)

data = response.json()
print(data)

Response

{
  "data": {
    "app": {
      "appId": "913335252",
      "title": "Brilliant: Learn by doing",
      "url": "https://apps.apple.com/us/app/brilliant-learn-by-doing/id913335252",
      "icon": "https://is1-ssl.mzstatic.com/image/thumb/Purple221/v4/c8/d1/72/c8d172e7-1a89-cc7d-2a2e-4e8b3e6a1a2e/AppIcon-0-0-1x_U007emarketing-0-7-0-85-220.png/512x512bb.jpg",
      "description": "Master concepts in math, data science, and computer science through fun, bite-sized lessons. Brilliant makes learning interactive — you won't just watch, you'll solve puzzles, build intuition, and develop real skills.",
      "rating": 4.74,
      "ratingMax": 5,
      "reviewsCount": 27315,
      "isFree": true,
      "price": 0,
      "formattedPrice": "Free",
      "mainCategory": "Education",
      "categories": ["Education", "Reference"],
      "developer": "Brilliant.org",
      "lastUpdateDate": "2026-01-26T12:19:36Z",
      "screenshots": [
        "https://is1-ssl.mzstatic.com/image/thumb/Purple221/v4/.../screen1.jpg",
        "https://is1-ssl.mzstatic.com/image/thumb/Purple221/v4/.../screen2.jpg",
        "https://is1-ssl.mzstatic.com/image/thumb/Purple221/v4/.../screen3.jpg"
      ],
      "provider": "Brilliant.org",
      "fileSizeBytes": "88879104",
      "minimumOsVersion": "17.0",
      "contentAdvisoryRating": "4+",
      "languageCodes": ["EN"],
      "inAppPurchases": [
        { "name": "Brilliant Premium", "formattedPrice": "$149.99" },
        { "name": "Brilliant Premium", "formattedPrice": "$127.99" },
        { "name": "Brilliant Premium: Fun, challenging problems in math and science by experts", "formattedPrice": "$24.99" },
        { "name": "Brilliant Premium", "formattedPrice": "$24.99" },
        { "name": "Brilliant Premium - Personal stats & exclusive problems", "formattedPrice": "$19.99" }
      ]
    },
    "market": {
      "estimatedDownloads": 2458350,
      "downloadsRange": { "low": 1229175, "high": 4916700 },
      "downloadsSource": "reviews-heuristic",
      "downloadsDisclaimer": "Estimated total lifetime downloads · reviewsCount × 90 (Education benchmark)",
      "downloadsConfidence": "low",
      "topFreeRank": null,
      "topPaidRank": null,
      "downloadsTrend": null,
      "estimatedRevenue": 14045,
      "revenueRange": { "low": 4214, "high": 42135 },
      "revenueSource": "iap-heuristic",
      "revenueDisclaimer": "Estimated daily revenue (USD) · ARPU × engagement model (Education)",
      "revenueConfidence": "medium",
      "revenueTrend": null,
      "topGrossingRank": null,
      "topGrossingCategory": "Education",
      "topCountries": [
        { "code": "US", "name": "United States", "share": 100 }
      ],
      "sentiment": {
        "positive": 95,
        "negative": 5,
        "basedOnRatings": 27315
      },
      "appPower": null
    },
    "similarApps": []
  }
}

App Object

Field	Type	Description
appId	string	Apple App ID
title	string	App name
url	string	App Store URL
icon	string	App icon URL (512px)
description	string	Full app description
rating	number	Average star rating (0–5)
ratingMax	number	Always `5`
reviewsCount	number	Total number of ratings
isFree	boolean	`true` if price is 0
price	number	App price in USD (0 = free)
formattedPrice	string	Localized price string (e.g. `"Free"`, `"$4.99"`)
mainCategory	string	Primary category (e.g. `Education`)
categories	string[]	All categories
developer	string	Developer name
lastUpdateDate	string	Last update date (ISO 8601)
screenshots	string[]	Screenshot URLs (max 6)
provider	string	Publisher / provider name
fileSizeBytes	string	App size in bytes
minimumOsVersion	string	Minimum iOS version (e.g. `17.0`)
contentAdvisoryRating	string	Age rating (e.g. `4+`, `12+`, `17+`)
languageCodes	string[]	Supported language codes (e.g. `["EN","FR"]`)
inAppPurchases	array	In-app purchase / subscription list (see below)

In-App Purchases

Field	Type	Description
name	string	Purchase name (e.g. `"Premium Annual Plan"`)
formattedPrice	string	Localized price (e.g. `"$149.99"`, `"$24.99"`)

In-app purchases are sourced from the official App Store web page. Apple embeds this data in structured JSON on the product page. The list includes all subscriptions, consumables, and non-consumables visible on the App Store listing.

Market Object

Downloads

Field	Type	Description
estimatedDownloads	number	Estimated downloads (daily if chart-based, lifetime if heuristic)
downloadsRange	object	`{ low, high }` confidence interval
downloadsSource	string	`"top-free-chart"`, `"top-paid-chart"`, or `"reviews-heuristic"`
downloadsDisclaimer	string	Human-readable methodology note
downloadsConfidence	string	`"high"`, `"medium"`, or `"low"`
topFreeRank	number \| null	Rank on Top Free chart (`null` if not charting)
topPaidRank	number \| null	Rank on Top Paid chart (`null` if not charting)
downloadsTrend	string \| null	`"up"`, `"down"`, or `null`

How downloads are estimated (similar to Sensor Tower, AppTweak):

Top Free/Paid chart (high confidence): Power-law model calibrated per category. Top 1 free app ≈ 500K–1.5M downloads/day, dropping off steeply by rank.
Reviews heuristic (low confidence): reviewsCount × category ratio (industry benchmark: 1 review per 60–200 downloads depending on category).

The downloadsSource field tells you which method was used, and downloadsConfidence indicates reliability.

Revenue

Field	Type	Description
estimatedRevenue	number	Estimated daily revenue (USD)
revenueRange	object	`{ low, high }` confidence interval
revenueSource	string	`"top-grossing-chart"`, `"paid-price-model"`, or `"iap-heuristic"`
revenueDisclaimer	string	Human-readable methodology note
revenueConfidence	string	`"high"`, `"medium"`, or `"low"`
revenueTrend	string \| null	`"up"`, `"down"`, or `null`
topGrossingRank	number \| null	Rank on Top Grossing chart (`null` if not charting)
topGrossingCategory	string \| null	Category for Top Grossing rank

How revenue is estimated (modeled after industry leaders):

Top Grossing chart (high confidence): Power-law model with category-specific parameters. Games top 1 ≈ $2.5M/day, Finance top 1 ≈$ 1.4M/day.
Paid price model (medium confidence): price × estimated daily sales × 0.70 net (Apple takes a 30% cut).
IAP/subscription heuristic (low confidence): estimated MAU × monthly ARPU / 30 where ARPU varies by category (Games $0.80, Music$ 2.50, Finance $1.80, Education$ 1.20).

Sentiment

Field	Type	Description
positive	number	Positive sentiment percentage (0–100)
negative	number	Negative sentiment percentage (0–100)
basedOnRatings	number	Number of ratings used for sentiment calculation

Other Market Fields

Field	Type	Description
topCountries	array	Countries with `code`, `name`, `share` (percentage)
appPower	number \| null	Composite score (reserved for future use)

The topCountries array is derived from country rankings. The share percentage indicates the relative distribution of the app’s chart presence across countries. If the app only charts in one country, that country will show 100 share.

Similar Apps (Deprecated)

The similarApps field in the intelligence response is now always an empty array. Use the dedicated GET /v1/apps/:id/similar endpoint instead. This separation allows the intelligence report to return much faster (~4-6s vs 30+s).

Field	Type	Description
similarApps	array	Always `[]` — use `/v1/apps/:id/similar` instead

Errors

Status	Code	When
400	INVALID_APP_ID	Non-numeric or missing app ID
401	MISSING_API_KEY	No API key in the request
401	INVALID_API_KEY	Invalid or expired API key
404	APP_NOT_FOUND	App not found or unavailable

Getting Started

Apps

My Data - Appeeky Web

Keywords

ASO Tools

AI Visibility

Search & Discovery

Market Intelligence

RevenueCat

App Store Connect

Google Play Console

Apple Search Ads

Growth Channels

Reference

Path Parameters

Query Parameters

Code Examples

Response

App Object

In-App Purchases

Market Object

Downloads

Revenue

Sentiment

Other Market Fields

Similar Apps (Deprecated)

Errors

​Path Parameters

​Query Parameters

​Code Examples

​Response

​App Object

​In-App Purchases

​Market Object

​Downloads

​Revenue

​Sentiment

​Other Market Fields

​Similar Apps (Deprecated)

​Errors

Path Parameters

Query Parameters

Code Examples

Response

App Object

In-App Purchases

Market Object

Downloads

Revenue

Sentiment

Other Market Fields

Similar Apps (Deprecated)

Errors