> ## 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](https://docs.appeeky.com/docs/platforms.md) |
| 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

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

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

> [!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](https://docs.appeeky.com/docs/get-app-intelligence.md) 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 in the specified country |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.