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
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 Apple App Store - (e.g for Facebook the ID is
284882215). Either this or the bundleId field must be specified.
|
Existing App ID on Apple App Store |
|
bundleId |
conditional |
The app bundleId on the Apple App 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 Apple App 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
This request can also be imported into Postman.
Check out our Postman integration guide.
Example Response
{
"stores": {
"itunes": [
{
"artworkUrl100": "https://is3-ssl.mzstatic.com/image/thumb/Purple116/v4/ef/de/c3/efdec33e-4bf3-4baa-6888-1da1041faa8f/AppIcon-1x_U007emarketing-0-7-0-85-220.png/100x100bb.jpg",
"trackId": 1094591345,
"trackViewUrl": "https://apps.apple.com/us/app/pok%C3%A9mon-go/id1094591345?uo=4&at=10l9yE",
"trackCensoredName": "Pok\u00e9mon GO",
"bundleId": "com.nianticlabs.pokemongo",
"artistName": "Niantic, Inc.",
"market_source": "ITUNES",
"market_status": "PUBLISHED"
}
],
"play": [
{
"package_name": "com.nianticlabs.pokemongo",
"title": "Pok\u00e9mon GO",
"developer": "Niantic, Inc.",
"icon": "https://play-lh.googleusercontent.com/0vpq7Mu6ZEloYsC6kJFJRRHidRQzZf9loRcOcBh03GT2DNQiX_Z-uS9tyYuaHZIDKCI=s180",
"market_source": "GOOGLE",
"market_status": "PUBLISHED",
"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