Lookup API for iOS App

Returns meta data of iPhone and iPad apps on Apple App Store that match a given iOS app track ID.



GET https://data.42matters.com/api/v2.0/ios/apps/lookup.json

Hits per request:


Rate limit:

50 QPS

Required plan:

basic or above.


Name Required Description Available Values Default
access_token required Your access token for using this API. You can get it for FREE by signing up .
id required The app ID on the iTunes store - (e.g for Facebook the ID is 284882215). Existing App ID on iTunes Store
bundleId optional The app bundleId on the iTunes store (e.g for Angry Birds the bundleId is com.clickgamer.AngryBirds). Note: this parameter is required if no id parameter is specified. Existing App bundleId on iTunes Store
include_unpublished optional Flag whether to return unpublished apps true, false false
lang optional The language you want to use when returning app data. If no translation is available the default language of the app is used. Internationalized fields include include trackCensoredName, screenshotUrls, releaseNotes, ipadScreenshotUrls, description. ID of Supported Languages en
app_country optional Return country-specific app metadata. Country-specific fields are include currency, price, formattedPrice. If the country is not supported, then the default metadata of the app is returned. ID of Supported Countries US
fields optional Comma-separated list of fields to return
callback optional If supplied, the response will use the JSONP format with a callback of the given name.


Status Code Indication Content-Type Body
200 Everything is OK application/json iOS app object
404 The track id/bundle id is not found application/json Error object
402 Your request exceeds what's allowed by your current subscription plan application/json Error object
403 Your access token is not valid application/json Error object
429 Your request rate is over the limit application/json Error object

Example Request

Example Response

	"contentAdvisoryRating": "4+",
	"releaseDate": "2009-12-11T08:00:00+00:00",
	"isVppDeviceBasedLicensingEnabled": true,
	"fileSizeBytesNumeric": 160458752,
	"trackId": 343200656,
	"ipadScreenshotUrls": [
	"primaryGenreId": 6014,
	"primaryGenreName": "Games",
	"averageUserRatingForCurrentVersion": 3.5,
	"trackCensoredName": "AB Classic",
	"genreIds": [
	"releaseNotes": "We addressed some minor issues in order to improve the user experience. Thanks for playing, and keep popping those pigs!",
	"sellerUrl": "https://www.rovio.com",
	"currentVersionReleaseDate": "2018-09-26T22:12:00+00:00",
	"averageUserRating": 4.5,
	"sellerName": "Rovio Entertainment Oyj",
	"userRatingCountForCurrentVersion": 112,
	"app_availability": {
		"available_in": [
		"not_available_in": [
		"availability_unknown": [
		"trackId": 343200656,
		"bundleId": "com.clickgamer.AngryBirds"
	"artworkUrl60": "https://is3-ssl.mzstatic.com/image/thumb/Purple118/v4/af/42/10/af421021-ef99-5a17-a0fb-b511e7be4eba/source/60x60bb.jpg",
	"version": "7.9.7",
	"languageCodesISO2A": [
	"trackViewUrl": "http://itunes.apple.com/app/ab-classic/id343200656?uo=5&at=10l9yE",
	"screenshotUrls": [
	"userRatingCount": 825473,
	"formattedPrice": "Free",
	"artistViewUrl": "https://itunes.apple.com/us/developer/rovio-entertainment-oyj/id298910979?uo=4",
	"artworkUrl100": "https://is3-ssl.mzstatic.com/image/thumb/Purple118/v4/af/42/10/af421021-ef99-5a17-a0fb-b511e7be4eba/source/100x100bb.jpg",
	"features": [
	"artworkUrl512": "https://is3-ssl.mzstatic.com/image/thumb/Purple118/v4/af/42/10/af421021-ef99-5a17-a0fb-b511e7be4eba/source/512x512bb.jpg",
	"bundleId": "com.clickgamer.AngryBirds",
	"iphone": true,
	"ipad": true,
	"fileSizeBytes": "160458752",
	"artistName": "Rovio Entertainment Oyj",
	"minimumOsVersion": "8.0",
	"currency": "USD",
	"artistId": 298910979,
	"genres": [
	"market_source": "ITUNES",
	"isGameCenterEnabled": true,
	"description": "Use the unique powers of the Angry Birds to destroy the greedy pigs' defenses!\u2028\u2028\n\nThe survival of the Angry Birds is at stake. Dish out revenge on the greedy pigs who stole their eggs. Use the unique powers of each bird to destroy the pigs\u2019 defenses. Angry Birds features challenging physics-based gameplay and hours of replay value. Each level requires logic, skill and force to solve.\u2028\u2028\n\nIf you get stuck in the game, you can purchase the Mighty Eagle! Mighty Eagle is a one-time in-app purchase in Angry Birds that gives unlimited use. This phenomenal creature will soar from the skies to wreak havoc and smash the pesky pigs into oblivion. There\u2019s just one catch: you can only use the aid of Mighty Eagle to pass a level once per hour. Mighty Eagle also includes all new gameplay goals and achievements!\u2028\u2028\n\nIn addition to the Mighty Eagle, Angry Birds now has power-ups! Boost your birds\u2019 abilities and three-star levels to unlock secret content! Angry Birds now has the following amazing power-ups: Sling Scope for laser targeting, King Sling for maximum flinging power, Super Seeds to supersize your birds, and Birdquake to shake pigs\u2019 defenses to the ground!\u2028\u2028\n\nHAVING TROUBLE? Head over to https://support.rovio.com where you can browse FAQs or submit a request to our support flock!\n\nTerms of Use: https://www.rovio.com/terms-of-service\nPrivacy Policy: https://www.rovio.com/privacy\n\nThis application may require internet connectivity and subsequent data transfer charges may apply.\n\n\nImportant Message for Parents\n\nThis game may include:\n- Direct links to social networking websites that are intended for an audience over the age of 13.\n- Direct links to the internet that can take players away from the game with the potential to browse any web page.\n- Advertising of Rovio products and also products from select partners.\n- The option to make in-app purchases. The bill payer should always be consulted beforehand.",
	"price": 0,
	"i18n_lang": [
	"trackContentRating": "4+",
	"supportedDevices": [
	"market_status": "PUBLISHED"

Last Modified: 2018-05-31

Automate your workflow

Bring app data into your existing workflow, dashboards, CRM, messaging platforms and many more services! Here a selection of third-party services we support:











And many more!