GET /v1/apps/:id
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 |
| 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
curl -X GET "https://api.appeeky.com/v1/apps/1617391485?country=us&device=iphone" \
-H "X-API-Key: YOUR_API_KEY"
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);
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
{
"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 |
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.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 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 |