Country Availability API for iOS Apps
Check in which countries (stores) an iOS app is available.
Definition
Endpoint:
GET
https://data.42matters.com/api/v2.0/ios/apps/availability.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 |
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 |
|
country |
optional |
Comma-separated list of country codes. Filters availability information only for specific
countries.
|
ID of Supported Countries |
|
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 |
results |
Array |
List of Availability objects. Each Availability object contains trackId, bundleId,
available_in,
not_available_in and availability_unknown |
|
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
{
"results": [
{
"available_in": [
"DO",
"FR",
"BG",
"DK",
"BE",
"HR",
"DE",
"JP",
"HU",
"HK",
"BR",
"FI",
"RU",
"NL",
"PT",
"NO",
"TW",
"NZ",
"LV",
"LT",
"TH",
"PE",
"PH",
"RO",
"AE",
"EG",
"PL",
"CH",
"CO",
"GR",
"CL",
"EE",
"CA",
"IT",
"VN",
"ZA",
"CZ",
"AR",
"AU",
"AT",
"IN",
"ID",
"ES",
"SG",
"US",
"GB",
"SK",
"KR",
"MY",
"MX",
"SE",
"IL"
],
"not_available_in": [
"CN",
"RS",
"TR",
"UK",
"SA",
"UA"
],
"availability_unknown": [
],
"trackId": 1094591345,
"bundleId": "com.nianticlabs.pokemongo"
}
]
}
Last Modified: 24 Jan 2019