IAB Category API for iOS Apps


Return the default store category and IAB category for every iOS apps. You can also use the Advanced Query API to filter by IAB categories, starting from Professional plan or higher.

Definition

Endpoint:

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

Hits per request:

3

Rate limit:

30 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_v2 Array of Objects List of IAB v2.0 categories in the response. Each category contains: id, parent_id, name, 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_v2": [
		{
			"id": 628,
			"parent_id": 619,
			"name": "Social Networking",
			"type": "declared_by_dev"
		},
		{
			"id": 619,
			"parent_id": 599,
			"name": "Internet",
			"type": "declared_by_dev"
		},
		{
			"id": 599,
			"parent_id": 596,
			"name": "Computing",
			"type": "declared_by_dev"
		},
		{
			"id": 596,
			"parent_id": null,
			"name": "Technology & Computing",
			"type": "declared_by_dev"
		},
		{
			"id": 239,
			"parent_id": null,
			"name": "Hobbies & Interests",
			"type": "declared_by_dev"
		},
		{
			"id": 188,
			"parent_id": 186,
			"name": "Dating",
			"type": "inferred"
		},
		{
			"id": 186,
			"parent_id": null,
			"name": "Family and Relationships",
			"type": "inferred"
		}
	]
}

Last Modified: 2018-05-31


Automate your workflow


Bring app data into your existing workflow, dashboards, CRM, messaging platforms and many more services! Here a selection of third-party services we support:



Email

Salesforce

HubSpot

Slack

Intercom

Pipedrive

Zendesk

Gekoboard

Klipfolio

Dynamics


And many more!


GET FREE INTEGRATIONS via Zapier!