Skip to main content
GET /v1/apps/:id
Fetch complete app metadata from the iTunes Lookup API. Results are cached for performance.

​
Path Parameters

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

​
Query Parameters

NameTypeDefaultDescription
countrystringusISO country code (e.g. us, gb, de, jp)
devicestringiphoneDevice type: iphone or ipad

​
Code Examples

curl -X GET "https://api.appeeky.com/v1/apps/1617391485?country=us&device=iphone" \
  -H "X-API-Key: YOUR_API_KEY"

​
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

FieldTypeDescription
appIdstringApple App ID
titlestringApp name
developerstringDeveloper / publisher name
iconUrlstring | nullApp icon URL (512px)
averageUserRatingnumber | nullAverage star rating (0–5)
userRatingCountnumber | nullTotal number of ratings
metadataobjectFull iTunes Lookup response (see below)

​
Metadata Object (iTunes Lookup)

FieldTypeDescription
trackIdnumberApple App ID (numeric)
trackNamestringApp name
artistNamestringDeveloper name
bundleIdstringBundle identifier (e.g. com.tsgames.blockblast)
artworkUrl100stringIcon URL 100px
artworkUrl512stringIcon URL 512px
descriptionstringFull app description
pricenumberApp price (0 = free)
primaryGenreNamestringPrimary category (e.g. Games)
genresstring[]All categories
averageUserRatingnumberStar rating (0–5)
userRatingCountnumberTotal ratings count
versionstringCurrent version
releaseNotesstringLatest version release notes
releaseDatestringOriginal release date (ISO 8601)
currentVersionReleaseDatestringCurrent version release date (ISO 8601)
trackViewUrlstringApp Store URL
fileSizeBytesstringApp size in bytes
minimumOsVersionstringMinimum iOS version (e.g. 16.0)
contentAdvisoryRatingstringAge rating (e.g. 4+, 12+)
languageCodesISO2Astring[]Supported language codes (e.g. ["EN","FR"])
screenshotUrlsstring[]iPhone screenshot URLs
ipadScreenshotUrlsstring[]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

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