> ## Documentation Index
> Fetch the complete documentation index at: https://docs.appeeky.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get App Intelligence

> Full intelligence report - metadata, revenue, downloads, IAPs, sentiment

```
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.

<Note>
  **Similar apps have moved to a dedicated endpoint.** Use [`GET /v1/apps/:id/similar`](/docs/get-similar-apps) to fetch similar apps separately. The intelligence endpoint now returns `similarApps: []` by default.
</Note>

## 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](/docs/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

<CodeGroup>
  ```bash cURL theme={"theme":{"light":"github-light","dark":"github-dark"}}
  curl -X GET "https://api.appeeky.com/v1/apps/913335252/intelligence?country=us" \
    -H "X-API-Key: YOUR_API_KEY"
  ```

  ```javascript JavaScript theme={"theme":{"light":"github-light","dark":"github-dark"}}
  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);
  ```

  ```python Python theme={"theme":{"light":"github-light","dark":"github-dark"}}
  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)
  ```
</CodeGroup>

## Response

```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
  "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"`) |

<Tip>
  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.
</Tip>

***

## 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`                                       |

<Tip>
  **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.
</Tip>

### 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                                     |

<Tip>
  **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, 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, Music $2.50, Finance $1.80, Education $1.20).
</Tip>

### 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)           |

<Note>
  The `topCountries` array is derived from [country rankings](/docs/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.
</Note>

***

## Similar Apps (Deprecated)

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

| 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  |