IAB Category API for iOS Apps


Return the default store category and IAB category for every iOS apps.

Definition

Endpoint:

GET https://data.42matters.com/api/v2.0/ios/apps/category.json

Hits per request:

3

Rate limit:

50 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
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
Attribute Type Description
trackId String Numeric unique identifier for the app assigned by Apple
bundleId String Unique identifier for the app assigned by the developer.
trackCensoredName String App title
trackViewUrl URL Link to the app on the Apple App Store
trackContentRating String Advisory rating of the app content
primaryGenreName String Name of the primary genre of the app
primaryGenreId Integer Unique primary genre identifier. See App Store Genres for more information.
genreIds List List of numeric genreIds of the app. Refer to the App Store Genres for more information.
iab Array of Objects List of IAB categories in the response. Each category contains: id, name, type (type can be "declared_by_dev" or "inferred").
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

{
	"trackId": 547702041,
	"bundleId": "com.cardify.tinder",
	"trackViewUrl": "http://itunes.apple.com/app/tinder/id547702041?uo=5",
	"trackCensoredName": "Tinder",
	"trackContentRating": "17+",
	"primaryGenreName": "Lifestyle",
	"primaryGenreId": 6012,
	"genreIds": [
		"6005",
		"6012"
	],
	"iab": [
		{
			"id": "IAB14",
			"name": "Society",
			"type": "declared_by_dev"
		},
		{
			"id": "IAB14-1",
			"name": "Dating",
			"type": "inferred"
		}
	]
}

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