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

Hits per request:

3

Rate limit:

50 QPS

Required plan:

Medium 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 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
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

IAB categories for Tinder - Dating. Meet Friends on iOS by its ID::

https://data.42matters.com/api/v4.0/ios/apps/category.json?id=547702041&access_token=YOUR_ACCESS_TOKEN

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

Example Response

{
  "trackId": 547702041,
  "bundleId": "com.cardify.tinder",
  "trackViewUrl": "https://apps.apple.com/us/app/tinder-dating-meet-friends/id547702041?uo=4",
  "trackCensoredName": "Tinder - Dating. Meet Friends",
  "trackContentRating": "17+",
  "primaryGenreName": "Lifestyle",
  "primaryGenreId": 6012,
  "genreIds": [
    "6012",
    "6005"
  ],
  "sellerName": "Tinder Inc.",
  "sellerUrl": "https://tinder.com",
  "iab": [
    {
      "id": "IAB9",
      "name": "Hobbies & Interests",
      "type": "declared_by_dev"
    },
    {
      "id": "IAB14-1",
      "name": "Dating",
      "type": "inferred"
    },
    {
      "id": "IAB14",
      "name": "Society",
      "type": "inferred"
    }
  ],
  "iab_v2": [
    {
      "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: 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:



Salesforce

Salesforce

HubSpot

HubSpot

Slack

Slack

Intercom

Intercom

Pipedrive

Pipedrive

Zendesk

Zendesk

Gekoboard

Gekoboard

Klipfolio

Klipfolio

Dynamics

Dynamics


And many more!


CONTACT SALES