IAB Category API for iOS Apps
Return the default Apple App Store category and IAB category for iOS apps.
The Advanced Query API allows to filter by IAB categories, starting from Medium plan or higher.
Definition
Endpoint:
GET
https://data.42matters.com/api/v4.0/ios/apps/category.json
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 |
sellerName |
String |
Seller company name |
sellerUrl |
URL |
Link to the seller company website |
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. |
|
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": "https://apps.apple.com/us/app/tinder-dating-meet-people/id547702041?uo=4",
"trackCensoredName": "Tinder - Dating & Meet People",
"trackContentRating": "17+",
"primaryGenreName": "Lifestyle",
"primaryGenreId": 6012,
"genreIds": [
"6012",
"6005"
],
"sellerName": "Tinder Inc.",
"sellerUrl": "http://www.gotinder.com/",
"iab": [
{
"type": "declared_by_dev",
"id": "IAB9",
"name": "Hobbies & Interests"
},
{
"type": "inferred",
"id": "IAB14-1",
"name": "Dating"
},
{
"type": "inferred",
"id": "IAB6",
"name": "Family & Parenting"
}
],
"iab_v2": [
{
"parent_id": null,
"type": "declared_by_dev",
"id": 239,
"name": "Hobbies & Interests"
},
{
"parent_id": 186,
"type": "inferred",
"id": 188,
"name": "Dating"
},
{
"parent_id": null,
"type": "inferred",
"id": 186,
"name": "Family and Relationships"
}
]
}
Last Modified: 29 Apr 2020