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

Hits per request:

1

Rate limit:

10 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
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",
				"NL",
				"PT",
				"NO",
				"CO",
				"TW",
				"NZ",
				"LV",
				"LT",
				"TH",
				"PE",
				"PH",
				"RO",
				"CA",
				"PL",
				"CH",
				"AE",
				"GR",
				"CL",
				"EE",
				"EG",
				"IT",
				"VN",
				"ZA",
				"CZ",
				"AR",
				"AU",
				"AT",
				"IN",
				"ID",
				"ES",
				"MY",
				"IL",
				"US",
				"SK",
				"KR",
				"SG",
				"MX",
				"SE",
				"GB"
			],
			"not_available_in": [
				"RU",
				"CN",
				"RS",
				"TR",
				"UK",
				"SA",
				"UA"
			],
			"availability_unknown": [
			],
			"trackId": 1094591345,
			"bundleId": "com.nianticlabs.pokemongo"
		}
	]
}

Last Modified: 2017-10-30


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