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:

Rate limit:

10 QPS

Required plan:

Small or above.

Parameters

Name	Required	Description	Available Values
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 Apple App Store - (e.g for Facebook the ID is 284882215).	Existing App ID on Apple App Store
bundleId	optional	The app bundleId on the Apple App 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 Apple App 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

Country Availability for Pokémon GO on iOS:

https://data.42matters.com/api/v2.0/ios/apps/availability.json?id=1094591345&access_token=YOUR_ACCESS_TOKEN

This request can also be imported into Postman. Check out our Postman integration guide.

Example Response

{
  "results": [
    {
      "available_in": [
        "DO",
        "FR",
        "BG",
        "DK",
        "BE",
        "HR",
        "DE",
        "JP",
        "HU",
        "HK",
        "JO",
        "BR",
        "FI",
        "NL",
        "PT",
        "NO",
        "CO",
        "TW",
        "TR",
        "NZ",
        "LV",
        "LT",
        "LU",
        "TH",
        "PE",
        "PK",
        "PH",
        "RO",
        "CA",
        "PL",
        "CH",
        "AE",
        "GR",
        "CL",
        "EE",
        "EG",
        "IT",
        "VN",
        "ZA",
        "CZ",
        "CY",
        "AR",
        "AU",
        "AT",
        "IN",
        "LB",
        "IE",
        "ID",
        "ES",
        "MA",
        "MY",
        "IL",
        "RS",
        "GE",
        "US",
        "SK",
        "KR",
        "SI",
        "SG",
        "MX",
        "SE",
        "GB"
      ],
      "not_available_in": [
        "CN",
        "IR",
        "AM",
        "NG",
        "TN",
        "DZ",
        "UK",
        "SA",
        "UA",
        "BY",
        "RU"
      ],
      "availability_unknown": [
      ],
      "trackId": 1094591345,
      "bundleId": "com.nianticlabs.pokemongo"
    }
  ]
}

Last Modified: 03 May 2023

Automate Your Workflow With 42matters’ APIs

Integrate app data and intelligence into your existing workflows, dashboards, CRM platforms, messaging platforms, and more! Below is a selection of the third-party services that are compatible with 42matters’ APIs: