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

Required plan:

basic or above.

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 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 metadata for locale 'en' 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 metadata for US 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
202 The app was not present in our databases and has been submitted for crawling. If the app is available anywhere, it will be available soon. application/json Error 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+",
	"supportedDevices": [
		"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",
		"iPad611-iPad611",
		"iPad612-iPad612",
		"iPad71-iPad71",
		"iPad72-iPad72",
		"iPad73-iPad73",
		"iPad74-iPad74",
		"iPhone8-iPhone8",
		"iPhone8Plus-iPhone8Plus",
		"iPhoneX-iPhoneX",
		"iPad75-iPad75",
		"iPad76-iPad76",
		"iPhoneXS-iPhoneXS",
		"iPhoneXSMax-iPhoneXSMax",
		"iPhoneXR-iPhoneXR",
		"iPad812-iPad812",
		"iPad834-iPad834",
		"iPad856-iPad856",
		"iPad878-iPad878"
	],
	"features": [
		"gameCenter"
	],
	"artworkUrl512": "https://is3-ssl.mzstatic.com/image/thumb/Purple128/v4/1b/cb/0e/1bcb0eeb-7606-85df-022e-3aeafce5e305/source/512x512bb.jpg",
	"releaseDate": "2009-12-11T08:00:00+00:00",
	"averageUserRatingForCurrentVersion": 3.5,
	"artistId": 298910979,
	"isVppDeviceBasedLicensingEnabled": true,
	"userRatingCountForCurrentVersion": 573,
	"fileSizeBytesNumeric": 161996800,
	"bundleId": "com.clickgamer.AngryBirds",
	"ipad": true,
	"app_availability": {
		"available_in": [
			"DO",
			"FR",
			"BG",
			"DK",
			"BE",
			"HR",
			"SG",
			"DE",
			"JP",
			"HU",
			"HK",
			"BR",
			"FI",
			"GR",
			"RU",
			"NL",
			"PT",
			"NO",
			"TW",
			"TR",
			"LT",
			"LV",
			"NZ",
			"TH",
			"PE",
			"PH",
			"RO",
			"AE",
			"EG",
			"PL",
			"CH",
			"CO",
			"CN",
			"CL",
			"EE",
			"CA",
			"IT",
			"VN",
			"ZA",
			"CZ",
			"AR",
			"AU",
			"AT",
			"IN",
			"ID",
			"ES",
			"MY",
			"US",
			"GB",
			"SK",
			"KR",
			"SA",
			"UA",
			"MX",
			"SE",
			"IL"
		],
		"not_available_in": [
			"UK",
			"RS"
		],
		"availability_unknown": [
		],
		"trackId": 343200656,
		"bundleId": "com.clickgamer.AngryBirds"
	},
	"trackId": 343200656,
	"review_analysis": {
		"total_reviews": 5096,
		"topics": [
			{
				"positive": 0.50008212068242,
				"topic_name": "General Feedback",
				"negative": 0.49991787931758,
				"reviews": 1527,
				"average_rating": 4.4106090373281,
				"topic_id": "general_feedback",
				"reviews_percentage": 0.10982451093211
			},
			{
				"positive": 0.49652690601681,
				"topic_name": "Stability",
				"negative": 0.50347309398319,
				"reviews": 894,
				"average_rating": 1.824384787472,
				"topic_id": "stability",
				"reviews_percentage": 0.064298043728423
			},
			{
				"positive": 0.42273673256873,
				"topic_name": "Advertising",
				"negative": 0.57726326743127,
				"reviews": 691,
				"average_rating": 1.5137481910275,
				"topic_id": "advertising",
				"reviews_percentage": 0.049697928653625
			},
			{
				"positive": 0.4367570645583,
				"topic_name": "Update",
				"negative": 0.5632429354417,
				"reviews": 548,
				"average_rating": 2.2773722627737,
				"topic_id": "update",
				"reviews_percentage": 0.039413118527043
			},
			{
				"positive": 0.40682246362252,
				"topic_name": "Pricing & Payments",
				"negative": 0.59317753637748,
				"reviews": 433,
				"average_rating": 2.1963048498845,
				"topic_id": "pricing_payments",
				"reviews_percentage": 0.031142117376295
			},
			{
				"positive": 0.35975773889534,
				"topic_name": "User Interface & UX",
				"negative": 0.64024226110466,
				"reviews": 288,
				"average_rating": 2.9930555555556,
				"topic_id": "user_interface",
				"reviews_percentage": 0.020713463751438
			},
			{
				"positive": 0.32342356438625,
				"topic_name": "Resource Usage",
				"negative": 0.67657643561375,
				"reviews": 232,
				"average_rating": 2.2198275862069,
				"topic_id": "resource_usage",
				"reviews_percentage": 0.01668584579977
			},
			{
				"positive": 0.40412371133993,
				"topic_name": "Video",
				"negative": 0.59587628866007,
				"reviews": 107,
				"average_rating": 1.9626168224299,
				"topic_id": "video",
				"reviews_percentage": 0.0076956271576525
			},
			{
				"positive": 0.44527854602876,
				"topic_name": "Audio",
				"negative": 0.55472145397124,
				"reviews": 96,
				"average_rating": 3.1770833333333,
				"topic_id": "audio",
				"reviews_percentage": 0.0069044879171461
			},
			{
				"positive": 0.6556077510276,
				"topic_name": "Uninstall",
				"negative": 0.3443922489724,
				"reviews": 78,
				"average_rating": 1.525641025641,
				"topic_id": "uninstall",
				"reviews_percentage": 0.0056098964326812
			},
			{
				"positive": 0.3478260869551,
				"topic_name": "Notifications & Alerts",
				"negative": 0.6521739130449,
				"reviews": 59,
				"average_rating": 2.0677966101695,
				"topic_id": "notification_alerts",
				"reviews_percentage": 0.0042433831990794
			},
			{
				"positive": 0.53315649867374,
				"topic_name": "Signup & Login",
				"negative": 0.46684350132626,
				"reviews": 46,
				"average_rating": 2.7391304347826,
				"topic_id": "signup_experience",
				"reviews_percentage": 0.0033084004602992
			},
			{
				"positive": 0.5487804878042,
				"topic_name": "Device Compatibility",
				"negative": 0.4512195121958,
				"reviews": 24,
				"average_rating": 3.3333333333333,
				"topic_id": "device_compatibility",
				"reviews_percentage": 0.0017261219792865
			},
			{
				"positive": 0.249999999999,
				"topic_name": "Tutorial",
				"negative": 0.750000000001,
				"reviews": 24,
				"average_rating": 1.9166666666667,
				"topic_id": "tutorial",
				"reviews_percentage": 0.0017261219792865
			},
			{
				"positive": 0.73770491803238,
				"topic_name": "Connectivity",
				"negative": 0.26229508196762,
				"reviews": 23,
				"average_rating": 2.2608695652174,
				"topic_id": "connectivity",
				"reviews_percentage": 0.0016542002301496
			},
			{
				"positive": 0.6,
				"topic_name": "Translation & Internationalization",
				"negative": 0.4,
				"reviews": 10,
				"average_rating": 4.3,
				"topic_id": "translation_internationalization",
				"reviews_percentage": 0.00071921749136939
			},
			{
				"positive": 0.57,
				"topic_name": "Privacy",
				"negative": 0.43,
				"reviews": 8,
				"average_rating": 2.125,
				"topic_id": "privacy",
				"reviews_percentage": 0.00057537399309551
			},
			{
				"positive": 0.81192660550459,
				"topic_name": "Location Services",
				"negative": 0.18807339449541,
				"reviews": 8,
				"average_rating": 2,
				"topic_id": "location_services",
				"reviews_percentage": 0.00057537399309551
			}
		],
		"number_topics": 18
	},
	"version": "8.0.0",
	"iphone": true,
	"primaryGenreId": 6014,
	"price": 0,
	"primaryGenreName": "Games",
	"fileSizeBytes": "161996800",
	"languageCodesISO2A": [
		"EN",
		"FR",
		"DE",
		"IT",
		"JA",
		"PT",
		"RU",
		"ZH",
		"ES",
		"ZH"
	],
	"isGameCenterEnabled": true,
	"trackCensoredName": "AB Classic",
	"genreIds": [
		"6014",
		"6016",
		"7001",
		"7003"
	],
	"trackViewUrl": "http://itunes.apple.com/app/ab-classic/id343200656?uo=5&at=10l9yE",
	"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",
	"screenshotUrls": [
		"https://is5-ssl.mzstatic.com/image/thumb/Purple118/v4/d1/0a/d2/d10ad2a3-4963-3c02-fb39-41988680982d/source/392x696bb.jpg",
		"https://is5-ssl.mzstatic.com/image/thumb/Purple128/v4/c1/8f/93/c18f934c-c743-f2bf-6787-2ba2a961c706/source/392x696bb.jpg",
		"https://is1-ssl.mzstatic.com/image/thumb/Purple128/v4/2e/d5/f4/2ed5f486-709b-4990-79e0-429997963a51/source/392x696bb.jpg",
		"https://is5-ssl.mzstatic.com/image/thumb/Purple118/v4/ee/9b/2f/ee9b2fb0-dfaf-d5bb-9c37-4bf2cac6d0d3/source/392x696bb.jpg",
		"https://is3-ssl.mzstatic.com/image/thumb/Purple118/v4/c3/c4/32/c3c432d3-c5b1-039e-1e17-9f79daf70348/source/392x696bb.jpg"
	],
	"currentVersionReleaseDate": "2018-10-30T08:46:30+00:00",
	"userRatingCount": 826315,
	"trackContentRating": "4+",
	"i18n_lang": [
		"ru",
		"fr",
		"en",
		"zh",
		"pt",
		"de",
		"it",
		"ja",
		"es"
	],
	"formattedPrice": "Free",
	"ipadScreenshotUrls": [
	],
	"market_source": "ITUNES",
	"artistViewUrl": "https://itunes.apple.com/us/developer/rovio-entertainment-oyj/id298910979?uo=4",
	"currency": "USD",
	"averageUserRating": 4.5,
	"description": "The 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' 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\nFEATURES:\n\u2013 Enjoy fun and satisfying slingshot gameplay.\n\u2013 Play all 15 original Angry Birds episodes \u2013 over 680 levels! \n\u2013 Compete against other players in the Mighty League.\n\u2013 Boost your birds' destructive strength with powerups.\n\u2013 Download and play for free!\n\u2013 Play offline!\n\n\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\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\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.",
	"artworkUrl100": "https://is3-ssl.mzstatic.com/image/thumb/Purple128/v4/1b/cb/0e/1bcb0eeb-7606-85df-022e-3aeafce5e305/source/100x100bb.jpg",
	"artistName": "Rovio Entertainment Oyj",
	"minimumOsVersion": "8.0",
	"artworkUrl60": "https://is3-ssl.mzstatic.com/image/thumb/Purple128/v4/1b/cb/0e/1bcb0eeb-7606-85df-022e-3aeafce5e305/source/60x60bb.jpg",
	"sellerName": "Rovio Entertainment Oyj",
	"genres": [
		"Games",
		"Entertainment",
		"Action",
		"Arcade"
	],
	"lang": "en",
	"market_status": "PUBLISHED"
}

Last Modified: 2018-11-11


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:



Email

Salesforce

HubSpot

Slack

Intercom

Pipedrive

Zendesk

Gekoboard

Klipfolio

Dynamics


And many more!


GET FREE INTEGRATIONS via Zapier!