Developer resources

Get general interest categories — TikTok Business API

Get general interest categories · call it through Quantri360 with one API key for your own accounts / assets that you connected and authorized — 360 handles request signing and refreshing the authorization you granted.

Open in the API index TikTok Business platform page

Get general interest categories

GET/tool/interest_category/Via 360: GET https://partner.quantri360.com/v1/tiktok_business/tool/interest_category/

Description

Use this endpoint to get general interest category enumeration values.

> Note

> We recommend that you use the Consolidated Interest and Behavior API (/targeting/search/) to search for or list targeting categories and hashtags for interests and behaviors. This API provides a consolidated and efficient approach to access the necessary targeting information.

Request

Endpoint

GET https://partner.quantri360.com/v1/tiktok_business/tool/interest_category/

Authentication & shop

Name	In	Type	Sample	Description
Authorization	header	header	Bearer q360_live_ab12cd34_…	Khóa API của brand (tạo ở mục API key). Bắt buộc với mọi request. Brand suy từ key — không truyền mã brand.
platform_shop_id	query	string	7000000000000000001	Tài sản TikTok Business đã kết nối — "Mã tài sản" ở trang Nền tảng hoặc GET /v1/platforms (tài khoản quảng cáo cho Marketing API, tài khoản TikTok cho Organic / Messaging). Có thể bỏ khi chỉ kết nối một tài sản.

Request parameters

Name	In	Type	Required	Description
version	query	number	No	Version of interest category. Enum values:`1`(`interest_category`), `2` (`interest_category_v2`)。Default: `2`.
language	query	string	No	Category name language in repsonse. Default value: `en`. Supported languages: `en`, `zh`, `ja`, `de`, `es`, `fr`, `id`, `it`, `ko`, `ru`, `th`, `tr`, `vi`, `ar`, `pt`, `ms`. For details, see Enumeration - Language Code.
placements	query	string[]	No	The apps where you want to deliver your ads. For enum values, see Enumeration - Placement. The interest categories available for different placements may be different, and the field only takes effect when `version` = `2`.
special_industries	query	string[]	No	Special ad categories. Enum values: - `HOUSING`: Ads for real estate listings, homeowners insurance, mortgage loans or other related opportunities. - `EMPLOYMENT`: Ads for job offers, internship, professional certification programs or other related opportunities. - `CREDIT`: Ads for credit card offers, auto loans, long-term financing or other related opportunities. Note: This field is generally available to advertisers registered in America or Canada. Advertisers who are not registered in America or Canada but want to target these countries with special ad categories need to apply for an additional allowlist.

Request examples

curl -s "https://partner.quantri360.com/v1/tiktok_business/tool/interest_category/" \
  -H "Authorization: Bearer $KEY"

Python

import requests

KEY = "q360_live_..."  # khóa API của brand
r = requests.get(
    "https://partner.quantri360.com/v1/tiktok_business/tool/interest_category/",
    params={},
    headers={"Authorization": f"Bearer {KEY}"},
    timeout=60,
)
print(r.status_code)
print(r.json())

Node.js

const KEY = 'q360_live_...'; // khóa API của brand
const url = new URL('https://partner.quantri360.com/v1/tiktok_business/tool/interest_category/');
for (const [k, v] of Object.entries({})) url.searchParams.set(k, typeof v === 'object' ? JSON.stringify(v) : String(v));
const r = await fetch(url, {
  method: 'GET',
  headers: { Authorization: `Bearer ${KEY}` },
});
console.log(r.status, await r.json());

PHP

<?php
$key = 'q360_live_...'; // khóa API của brand
$url = 'https://partner.quantri360.com/v1/tiktok_business/tool/interest_category/' . '?' . http_build_query([]);
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, ['Authorization: Bearer ' . $key]);
$res = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
echo $status, "\n", $res;

Response

Response fields (as returned by TikTok Business)

Name	Type	Description
code	number	Return code. For the complete list of response codes and descriptions, see Appendix-Return codes.
message	string	Return message. For details, see Appendix-Return codes.
data	object	Return Data
interest_categories	object[]	Interest category list. To determine the corresponding names for gaming-related interest category IDs, see Interest category.
interest_category_id	string	Interest category ID
interest_category_name	string	Interest category name
level	number	Level
sub_category_ids	string[]	Subcategory ID list
special_industries	string[]	Special ad categories. Enum values: - `HOUSING`: Ads for real estate listings, homeowners insurance, mortgage loans or other related opportunities. - `EMPLOYMENT`: Ads for job offers, internship, professional certification programs or other related opportunities. - `CREDIT`: Ads for credit card offers, auto loans, long-term financing or other related opportunities. Note: - If the returned value is empty(`[]`), it means that the interest categories do not support any special ad categories.
placements	string[]	Available placement for this interest category. Returning an empty list means unlimited. Please refer to Enumeration-Placement for details of enum values.
request_id	string	The log id of a request, which uniquely identifies the request.

Response sample

HTTPS/1.1 200 OK
{
    "code": 0,
    "message": "OK",
    "request_id": "202206302233010102452460660B5E36E5",
    "data": {
        "interest_categories": [
            {
                "special_industries": [
                    "HOUSING",
                    "EMPLOYMENT",
                    "CREDIT"
                ],
                "placements": [],
                "interest_category_id": "10",
                "level": 1,
                "interest_category_name": "Education",
                "sub_category_ids": [
                    "10100",
                    "10101",
                    "10102",
                    "10103",
                    "10104",
                    "10105",
                    "10106"
                ]
            },
            {
                "special_industries": [
                    "HOUSING",
                    "EMPLOYMENT",
                    "CREDIT"
                ],
                "placements": [],
                "interest_category_id": "11",
                "level": 1,
                "interest_category_name": "Vehicles & Transportation",
                "sub_category_ids": [
                    "11100",
                    "11101",
                    "11102",
                    "11103",
                    "11104",
                    "11105",
                    "11106",
                    "11107",
                    "11108",
                    "11109",
                    "11111",
                    "11112"
                ]
            },
            ...
        ]
    }
}
(/code);

Get started

Sign up for Partner
Enable a data type of the Ads (Marketing API) group on the platform page
Create an API key (tick the TikTok Business channel)
Call it as in the examples above