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.

Definition

Endpoint:

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

Hits per request:

1

Rate limit:

50 QPS

Parameters

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 Angry Birds the ID is 343200656, see Angry Birds on iTunes). 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
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.

Responses

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

{
	"artistId": 298910979,
	"artistName": "Rovio Entertainment Ltd",
	"artistViewUrl": "https://itunes.apple.com/us/developer/rovio-entertainment-ltd/id298910979?uo=4&partnerId=11&at=10l9yE",
	"artworkUrl100": "http://is4.mzstatic.com/image/thumb/Purple111/v4/37/5d/f1/375df11d-a0f5-d5ea-fe00-0287738c1a7f/mzl.sorpgkjj.png/175x175bb-85.jpg",
	"artworkUrl512": "http://is2.mzstatic.com/image/thumb/Purple111/v4/84/da/2e/84da2e30-aa6f-0b88-f50e-4c72f22eacdc/source/512x512bb.jpg",
	"artworkUrl60": "http://is2.mzstatic.com/image/thumb/Purple111/v4/84/da/2e/84da2e30-aa6f-0b88-f50e-4c72f22eacdc/source/60x60bb.jpg",
	"averageUserRating": 4.5,
	"averageUserRatingForCurrentVersion": 3.5,
	"bundleId": "com.clickgamer.AngryBirds",
	"contentAdvisoryRating": "4+",
	"currency": "USD",
	"currentVersionReleaseDate": "2017-01-26T08:50:51+00:00",
	"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\n#1 IPHONE PAID APP in US, UK, Canada, Italy, Germany, Russia, Sweden, Denmark, Finland, Singapore, Poland, France, Netherlands, Malta, Greece, Austria, Australia, Turkey, UAE, Saudi Arabia, Israel, Belgium, Norway, Hungary, Malaysia, Luxembourg, Portugal, Czech Republic, Spain, Ireland, Romania, New Zealand, Latvia, Lithuania, Estonia, Nicaragua, Kazakhstan, Argentina, Bulgaria, Slovakia, Slovenia, Mauritius, Chile, Hong Kong, Pakistan, Taiwan, Colombia, Indonesia, Thailand, India, Kenya, Macedonia, Croatia, Macau, Paraguay, Peru, Armenia, Philippines, Vietnam, Jordan and Kuwait. \u2028\u2028\n\n#1 IPHONE PAID GAME in more countries than we can count!\n\nTerms of Use: http://www.rovio.com/eula\u2028\nPrivacy Policy: http://www.rovio.com/privacy\u2028\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.",
	"features": [
		"gameCenter"
	],
	"fileSizeBytes": "212724736",
	"fileSizeBytesNumeric": 212724736,
	"formattedPrice": "Free",
	"genreIds": [
		"6014",
		"6016",
		"7001",
		"7003"
	],
	"genres": [
		"Games",
		"Entertainment",
		"Action",
		"Arcade"
	],
	"i18n_lang": [
		"ru",
		"fr",
		"en",
		"zh",
		"pt",
		"de",
		"it",
		"ja",
		"es"
	],
	"ipad": true,
	"ipadScreenshotUrls": [
	],
	"iphone": true,
	"isGameCenterEnabled": false,
	"isVppDeviceBasedLicensingEnabled": true,
	"languageCodesISO2A": [
		"EN",
		"FR",
		"DE",
		"IT",
		"JA",
		"PT",
		"RU",
		"ZH",
		"ES",
		"ZH"
	],
	"minimumOsVersion": "7.0",
	"price": 0,
	"primaryGenreId": 6014,
	"primaryGenreName": "Games",
	"releaseDate": "2009-12-11T00:00:00+00:00",
	"releaseNotes": "A new level every day! Play a new, unique level in the Mighty League every day. Each new level is only around for 24 hours so make sure you don\u2019t miss a single one!",
	"screenshotUrls": [
		"http://a2.mzstatic.com/us/r30/Purple111/v4/55/3e/1c/553e1c80-960b-2205-f63a-3f3ee401ce3c/screen696x696.jpeg",
		"http://a4.mzstatic.com/us/r30/Purple111/v4/5b/c6/a6/5bc6a6a0-338e-3c06-fd4d-c4505dd5df6c/screen696x696.jpeg",
		"http://a1.mzstatic.com/us/r30/Purple122/v4/f2/dc/2d/f2dc2d4d-d19c-2741-1155-9e806d52e55b/screen696x696.jpeg",
		"http://a3.mzstatic.com/us/r30/Purple111/v4/00/32/0f/00320fe3-3c44-7009-b2b4-39ea6308229f/screen696x696.jpeg",
		"http://a1.mzstatic.com/us/r30/Purple111/v4/37/e3/36/37e336b2-1f7a-9e8f-0083-dd155ef8574d/screen696x696.jpeg"
	],
	"sellerName": "Rovio Entertainment Ltd",
	"sellerUrl": "http://www.rovio.com",
	"supportedDevices": [
		"iPhone4-iPhone4",
		"iPad2Wifi-iPad2Wifi",
		"iPad23G-iPad23G",
		"iPhone4S-iPhone4S",
		"iPadThirdGen-iPadThirdGen",
		"iPadThirdGen4G-iPadThirdGen4G",
		"iPhone5-iPhone5",
		"iPodTouchFifthGen-iPodTouchFifthGen",
		"iPadFourthGen-iPadFourthGen",
		"iPadFourthGen4G-iPadFourthGen4G",
		"iPadMini-iPadMini",
		"iPadMini4G-iPadMini4G",
		"iPhone5c-iPhone5c",
		"iPhone5s-iPhone5s",
		"iPadAir-iPadAir",
		"iPadAirCellular-iPadAirCellular",
		"iPadMiniRetina-iPadMiniRetina",
		"iPadMiniRetinaCellular-iPadMiniRetinaCellular",
		"iPhone6-iPhone6",
		"iPhone6Plus-iPhone6Plus",
		"iPadAir2-iPadAir2",
		"iPadAir2Cellular-iPadAir2Cellular",
		"iPadMini3-iPadMini3",
		"iPadMini3Cellular-iPadMini3Cellular",
		"iPodTouchSixthGen-iPodTouchSixthGen",
		"iPhone6s-iPhone6s",
		"iPhone6sPlus-iPhone6sPlus",
		"iPadMini4-iPadMini4",
		"iPadMini4Cellular-iPadMini4Cellular",
		"iPadPro-iPadPro",
		"iPadProCellular-iPadProCellular",
		"iPadPro97-iPadPro97",
		"iPadPro97Cellular-iPadPro97Cellular",
		"iPhoneSE-iPhoneSE",
		"iPhone7-iPhone7",
		"iPhone7Plus-iPhone7Plus"
	],
	"trackCensoredName": "Angry Birds",
	"trackContentRating": "4+",
	"trackId": 343200656,
	"trackViewUrl": "http://itunes.apple.com/app/angry-birds/id343200656?uo=5&at=10l9yE",
	"userRatingCount": 824512,
	"userRatingCountForCurrentVersion": 190,
	"version": "7.1.0"
}

Last Modified: 2016-09-26


Get Free Support


We offer free email support to all our customers, with the 42matters team glad to provide you prompt, professional support. We’re here to help.


CONTACT US    KNOWLEDGE BASE