Skip to main content
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

NameTypeRequiredDescription
idstringYesApple App ID (numeric, e.g. 913335252)

​
Query Parameters

NameTypeDefaultDescription
countrystringusISO country code (e.g. us, gb, de)

​
Code Examples

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

​
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

FieldTypeDescription
appIdstringApple App ID
titlestringApp name
urlstringApp Store URL
iconstringApp icon URL (512px)
descriptionstringFull app description
ratingnumberAverage star rating (0–5)
ratingMaxnumberAlways 5
reviewsCountnumberTotal number of ratings
isFreebooleantrue if price is 0
pricenumberApp price in USD (0 = free)
formattedPricestringLocalized price string (e.g. "Free", "$4.99")
mainCategorystringPrimary category (e.g. Education)
categoriesstring[]All categories
developerstringDeveloper name
lastUpdateDatestringLast update date (ISO 8601)
screenshotsstring[]Screenshot URLs (max 6)
providerstringPublisher / provider name
fileSizeBytesstringApp size in bytes
minimumOsVersionstringMinimum iOS version (e.g. 17.0)
contentAdvisoryRatingstringAge rating (e.g. 4+, 12+, 17+)
languageCodesstring[]Supported language codes (e.g. ["EN","FR"])
inAppPurchasesarrayIn-app purchase / subscription list (see below)

​
In-App Purchases

FieldTypeDescription
namestringPurchase name (e.g. "Premium Annual Plan")
formattedPricestringLocalized 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

FieldTypeDescription
estimatedDownloadsnumberEstimated downloads (daily if chart-based, lifetime if heuristic)
downloadsRangeobject{ low, high } confidence interval
downloadsSourcestring"top-free-chart", "top-paid-chart", or "reviews-heuristic"
downloadsDisclaimerstringHuman-readable methodology note
downloadsConfidencestring"high", "medium", or "low"
topFreeRanknumber | nullRank on Top Free chart (null if not charting)
topPaidRanknumber | nullRank on Top Paid chart (null if not charting)
downloadsTrendstring | null"up", "down", or null
How downloads are estimated (similar to Sensor Tower, AppTweak):
  1. 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.
  2. 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

FieldTypeDescription
estimatedRevenuenumberEstimated daily revenue (USD)
revenueRangeobject{ low, high } confidence interval
revenueSourcestring"top-grossing-chart", "paid-price-model", or "iap-heuristic"
revenueDisclaimerstringHuman-readable methodology note
revenueConfidencestring"high", "medium", or "low"
revenueTrendstring | null"up", "down", or null
topGrossingRanknumber | nullRank on Top Grossing chart (null if not charting)
topGrossingCategorystring | nullCategory for Top Grossing rank
How revenue is estimated (modeled after industry leaders):
  1. Top Grossing chart (high confidence): Power-law model with category-specific parameters. Games top 1 ≈ 2.5M/day,Financetop1≈2.5M/day, Finance top 1 ≈ 1.4M/day.
  2. Paid price model (medium confidence): price × estimated daily sales × 0.70 net (Apple takes a 30% cut).
  3. IAP/subscription heuristic (low confidence): estimated MAU × monthly ARPU / 30 where ARPU varies by category (Games 0.80,Music0.80, Music 2.50, Finance 1.80,Education1.80, Education 1.20).

​
Sentiment

FieldTypeDescription
positivenumberPositive sentiment percentage (0–100)
negativenumberNegative sentiment percentage (0–100)
basedOnRatingsnumberNumber of ratings used for sentiment calculation

​
Other Market Fields

FieldTypeDescription
topCountriesarrayCountries with code, name, share (percentage)
appPowernumber | nullComposite 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).
FieldTypeDescription
similarAppsarrayAlways [] — use /v1/apps/:id/similar instead

​
Errors

StatusCodeWhen
400INVALID_APP_IDNon-numeric or missing app ID
401MISSING_API_KEYNo API key in the request
401INVALID_API_KEYInvalid or expired API key
404APP_NOT_FOUNDApp not found or unavailable