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

> Fetch full app metadata from iTunes Lookup API

```
GET /v1/apps/:id
```

Fetch complete app metadata from the iTunes Lookup API.

## Path Parameters

| Name | Type   | Required | Description                                                                              |
| ---- | ------ | -------- | ---------------------------------------------------------------------------------------- |
| id   | string | Yes      | App ID — numeric for Apple (`1617391485`), 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`, `jp`)                                   |
| device   | string | `iphone` | Device type: `iphone` or `ipad` (Apple only)                                     |
| 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/1617391485?country=us&device=iphone" \
    -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/1617391485?country=us&device=iphone",
    {
      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/1617391485",
      params={"country": "us", "device": "iphone"},
      headers={"X-API-Key": "YOUR_API_KEY"},
  )

  data = response.json()
  print(data)
  ```
</CodeGroup>

## Response

```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
  "data": {
    "appId": "1617391485",
    "title": "Block Blast!",
    "developer": "Hungry Studio",
    "iconUrl": "https://is1-ssl.mzstatic.com/image/thumb/Purple211/v4/07/07/46/070746fc-c20c-72d6-c067-f2e405e0c29e/AppIcon-0-0-1x_U007emarketing-0-7-0-85-220.png/512x512bb.jpg",
    "metadata": {
      "trackId": 1617391485,
      "trackName": "Block Blast!",
      "artistName": "Hungry Studio",
      "bundleId": "com.tsgames.blockblast",
      "artworkUrl100": "https://is1-ssl.mzstatic.com/image/thumb/Purple211/v4/07/07/46/070746fc-c20c-72d6-c067-f2e405e0c29e/AppIcon-0-0-1x_U007emarketing-0-7-0-85-220.png/100x100bb.jpg",
      "artworkUrl512": "https://is1-ssl.mzstatic.com/image/thumb/Purple211/v4/07/07/46/070746fc-c20c-72d6-c067-f2e405e0c29e/AppIcon-0-0-1x_U007emarketing-0-7-0-85-220.png/512x512bb.jpg",
      "description": "Block Blast is a classic yet addictive block puzzle game...",
      "price": 0,
      "primaryGenreName": "Games",
      "genres": ["Games", "Puzzle", "Casual"],
      "averageUserRating": 4.73321,
      "userRatingCount": 1832497,
      "version": "4.1.2",
      "releaseNotes": "Bug fixes and performance improvements.",
      "releaseDate": "2022-10-06T07:00:00Z",
      "currentVersionReleaseDate": "2026-01-28T15:42:00Z",
      "trackViewUrl": "https://apps.apple.com/us/app/block-blast/id1617391485",
      "fileSizeBytes": "227541504",
      "minimumOsVersion": "16.0",
      "contentAdvisoryRating": "4+",
      "languageCodesISO2A": ["EN", "FR", "DE", "ES", "IT", "JA", "KO", "PT", "ZH"],
      "screenshotUrls": [
        "https://is1-ssl.mzstatic.com/image/thumb/Purple211/v4/.../screen1.jpg",
        "https://is1-ssl.mzstatic.com/image/thumb/Purple211/v4/.../screen2.jpg",
        "https://is1-ssl.mzstatic.com/image/thumb/Purple211/v4/.../screen3.jpg"
      ],
      "ipadScreenshotUrls": [
        "https://is1-ssl.mzstatic.com/image/thumb/Purple211/v4/.../ipad-screen1.jpg"
      ]
    },
    "averageUserRating": 4.73321,
    "userRatingCount": 1832497
  }
}
```

## Top-Level Fields

| Field             | Type           | Description                             |
| ----------------- | -------------- | --------------------------------------- |
| appId             | string         | Apple App ID                            |
| title             | string         | App name                                |
| developer         | string         | Developer / publisher name              |
| iconUrl           | string \| null | App icon URL (512px)                    |
| averageUserRating | number \| null | Average star rating (0–5)               |
| userRatingCount   | number \| null | Total number of ratings                 |
| metadata          | object         | Full iTunes Lookup response (see below) |

## Metadata Object (iTunes Lookup)

| Field                     | Type      | Description                                       |
| ------------------------- | --------- | ------------------------------------------------- |
| trackId                   | number    | Apple App ID (numeric)                            |
| trackName                 | string    | App name                                          |
| artistName                | string    | Developer name                                    |
| bundleId                  | string    | Bundle identifier (e.g. `com.tsgames.blockblast`) |
| artworkUrl100             | string    | Icon URL 100px                                    |
| artworkUrl512             | string    | Icon URL 512px                                    |
| description               | string    | Full app description                              |
| price                     | number    | App price (0 = free)                              |
| primaryGenreName          | string    | Primary category (e.g. `Games`)                   |
| genres                    | string\[] | All categories                                    |
| averageUserRating         | number    | Star rating (0–5)                                 |
| userRatingCount           | number    | Total ratings count                               |
| version                   | string    | Current version                                   |
| releaseNotes              | string    | Latest version release notes                      |
| releaseDate               | string    | Original release date (ISO 8601)                  |
| currentVersionReleaseDate | string    | Current version release date (ISO 8601)           |
| trackViewUrl              | string    | App Store URL                                     |
| fileSizeBytes             | string    | App size in bytes                                 |
| minimumOsVersion          | string    | Minimum iOS version (e.g. `16.0`)                 |
| contentAdvisoryRating     | string    | Age rating (e.g. `4+`, `12+`)                     |
| languageCodesISO2A        | string\[] | Supported language codes (e.g. `["EN","FR"]`)     |
| screenshotUrls            | string\[] | iPhone screenshot URLs                            |
| ipadScreenshotUrls        | string\[] | iPad screenshot URLs                              |

<Note>
  The `metadata` object contains the **raw iTunes Lookup API response**. Additional fields beyond those listed above may be present depending on the app. The structure mirrors Apple's iTunes Search API output exactly.
</Note>

<Tip>
  Use this endpoint for **basic app lookups** (metadata, ratings, screenshots). For a full intelligence report including revenue estimates, download estimates, similar apps, and in-app purchases, use the [Intelligence endpoint](/docs/get-app-intelligence) instead.
</Tip>

## 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 in the specified country |