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

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 Angry Birds the ID is 343200656, see Angry Birds on iTunes). 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
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
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
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: 2016-09-26


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    KNOWLEDGE BASE