App Matching API for iOS Apps


Find an iOS apps' equivalents across different app stores. For example, given Facebook iOS version's track id on iTunes, this API will return Facebook Android version's information on Google Play.

Definition

Endpoint:

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

Hits per request:

3

Rate limit:

10 QPS

Required plan:

startup 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 conditional The app ID on the iTunes store - (e.g for Facebook the ID is 284882215). Either this or the bundleId field must be specified. Existing App ID on iTunes Store
bundleId conditional The app bundleId on the iTunes store (e.g for Angry Birds the bundleId is com.clickgamer.AngryBirds. Either this or the id field must be specified. Existing App bundleId on iTunes Store
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
Name Type Description
stores Object
Field Type Description
itunes List List of apps on iTunes. Each object contains trackId, bundleId, artworkUrl100, trackViewUrl, trackCensoredName, and artistName
play List List of apps on Google Play. Each object contains package_name, title, developer, icon and market_url
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

{
	"stores": {
		"itunes": [
			{
				"artworkUrl100": "http://is1.mzstatic.com/image/thumb/Purple118/v4/ff/32/02/ff320242-3360-31c0-918d-45acb52f0628/source/100x100bb.jpg",
				"trackId": 1094591345,
				"bundleId": "com.nianticlabs.pokemongo",
				"trackViewUrl": "http://itunes.apple.com/app/pok%C3%A9mon-go/id1094591345?uo=5&at=10l9yE",
				"trackCensoredName": "Pok\u00e9mon GO",
				"artistName": "Niantic, Inc."
			}
		],
		"play": [
			{
				"package_name": "com.nianticlabs.pokemongo",
				"title": "Pok\u00e9mon GO",
				"developer": "Niantic, Inc.",
				"icon": "https://lh3.googleusercontent.com/wPfLmWBJwsPdBhsFXc8X4QZOOvePWjoOBLFXXCwyegjRwYOuabmG5cynthlW0HDgy9s=w300",
				"market_url": "https://play.google.com/store/apps/details?id=com.nianticlabs.pokemongo&referrer=utm_source%3D42matters.com%26utm_medium%3Dapi"
			}
		]
	}
}

Last Modified: 2017-06-24


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