Developer resources

Get available content exclusion categories — TikTok Business API

Get available content exclusion 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 available content exclusion categories

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

Description

Use this endpoint to get content categories or vertical sensitivity categories that can be excluded from appearing next to your ads.

Request

Endpoint

GET https://partner.quantri360.com/v1/tiktok_business/tool/content_exclusion/get/

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	Sample	Description
objective_type	query	string	Yes		Advertising objective. Only supports `REACH`, `VIDEO_VIEWS` and `ENGAGEMENT`.
brand_safety_type	query	string	No		Brand safety type. Default value: `NO_BRAND_SAFETY`. Enum values: - `NO_BRAND_SAFETY`: To not use any brand safety solution. Full inventory, which means your ads may appear next to some content featuring mature themes. - `EXPANDED_INVENTORY`: Use TikTok's brand safety solution. Expanded inventory means that your ads will appear next to content where most inappropriate content has been removed, and that does not contain mature themes. In the next API version, `EXPANDED_INVENTORY` will replace `NO_BRAND_SAFETY` and will be the default brand safety option. Note:`EXPANDED_INVENTORY` is currently an allowlist-only feature. If you would like to access it, please contact your TikTok representative. - `STANDARD_INVENTORY`: Use TikTok's brand safety solution. Standard inventory means that ads will appear next to content that is appropriate for most brands. - `LIMITED_INVENTORY`: Use TikTok's brand safety solution. Limited inventory means that your ads will not appear next to content that contains mature themes. Note: - If you want to retrieve vertical sensitivity category IDs(`vertical_sensitivity_list`), you can only use `STANDARD_INVENTORY` or `LIMITED_INVENTORY`. - If you are not on the allowlist for vertical sensitivity, the `vertical_sensitivity_list` will be null in the response.

Request examples

curl -s "https://partner.quantri360.com/v1/tiktok_business/tool/content_exclusion/get/?objective_type=" \
  -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/content_exclusion/get/",
    params={
        "objective_type": ""
    },
    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/content_exclusion/get/');
for (const [k, v] of Object.entries({"objective_type":""})) 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/content_exclusion/get/' . '?' . http_build_query(['objective_type' => '']);
$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	Response code. For the complete list of error codes and descriptions, see Appendix - Return Codes.
message	string	Response message. For details, see Appendix - Return Codes.
request_id	string	The log ID of a request, which uniquely identifies the request.
data	object	Returned data.
excluded_category_list	object[]	A list of content exclusion categories.
category_id	string	Category ID.
category_name	string	Category name.
supported_regions	string[]	The country or region codes that the category supports.
description	string	Category description.
category_type	string	Category type. For `excluded_category_list`,`CATEGORY_TYPE_EXCLUSION`(content exclusion category ) will be returned .
vertical_sensitivity_list	object[]	A list of vertical categories containing sensitive content.
category_id	string	Category ID.
category_name	string	Category name.
supported_regions	string[]	The country or region codes that the category supports.
description	string	Category description.
category_type	string	Category type. For `vertical_sensitivity_list`,`CATEGORY_TYPE_VERTICAL`(vertical sensitivity category) will be returned.

Response sample

HTTPS/1.1 200 OK
{
    "code": 0,
    "message": "OK",
    "request_id": "{{request_id}}",
    "data": {
        "excluded_category_list": [
            {
                "description": "YouthContentDescriptionKey",
                "category_type": "CATEGORY_TYPE_EXCLUSION",
                "supported_regions": [
                    "US",
                    "GB",
                    "AU",
                    "CA"
                ],
                "category_id": "200",
                "category_name": "Youth content"
            },
            {
                "description": "CombatSportsDescriptionKey",
                "category_type": "CATEGORY_TYPE_EXCLUSION",
                "supported_regions": [
                    "US",
                    "GB",
                    "AU",
                    "CA"
                ],
                "category_id": "201",
                "category_name": "Combat sports"
            },
            {
                "description": "ViolentVideoGamesDescriptionKey",
                "category_type": "CATEGORY_TYPE_EXCLUSION",
                "supported_regions": [
                    "US",
                    "GB",
                    "AU",
                    "CA"
                ],
                "category_id": "202",
                "category_name": "Violent video games"
            },
            {
                "description": "GamblingDescriptionKey",
                "category_type": "CATEGORY_TYPE_EXCLUSION",
                "supported_regions": [
                    "US",
                    "GB",
                    "AU",
                    "CA"
                ],
                "category_id": "203",
                "category_name": "Gambling and lotteries"
            }
        ],
        "vertical_sensitivity_list": []
    }
}


{
    "code": 0,
    "message": "OK",
    "request_id": "{{request_id}}",
    "data": {
        "excluded_category_list": [
            {
                "category_type": "CATEGORY_TYPE_EXCLUSION",
                "category_id": "200",
                "category_name": "Youth content",
                "description": "YouthContentDescriptionKey",
                "supported_regions": [
                    "US",
                    "GB",
                    "AU",
                    "CA"
                ]
            },
            {
                "category_type": "CATEGORY_TYPE_EXCLUSION",
                "category_id": "201",
                "category_name": "Combat sports",
                "description": "CombatSportsDescriptionKey",
                "supported_regions": [
                    "US",
                    "GB",
                    "AU",
                    "CA"
                ]
            },
            {
                "category_type": "CATEGORY_TYPE_EXCLUSION",
                "category_id": "202",
                "category_name": "Violent video games",
                "description": "ViolentVideoGamesDescriptionKey",
                "supported_regions": [
                    "US",
                    "GB",
                    "AU",
                    "CA"
                ]
            },
            {
                "category_type": "CATEGORY_TYPE_EXCLUSION",
                "category_id": "203",
                "category_name": "Gambling and lotteries",
                "description": "GamblingDescriptionKey",
                "supported_regions": [
                    "US",
                    "GB",
                    "AU",
                    "CA"
                ]
            }
        ],
        "vertical_sensitivity_list": [
            {
                "category_type": "CATEGORY_TYPE_VERTICAL",
                "category_id": "1000",
                "category_name": "Beauty",
                "description": "This will exclude any content that TikTok deems as controversial or negative beauty-related patterns which may impact your campaign performance.",
                "supported_regions": [
                    "US",
                    "GB",
                    "AU",
                    "CA"
                ]
            },
            {
                "category_type": "CATEGORY_TYPE_VERTICAL",
                "category_id": "1001",
                "category_name": "Food",
                "description": "This will exclude any content that TikTok deems as unhealthy food behaviors, body shaming, or graphic food content which may impact your campaign performance.",
                "supported_regions": [
                    "US",
                    "GB",
                    "AU",
                    "CA"
                ]
            },
            {
                "category_type": "CATEGORY_TYPE_VERTICAL",
                "category_id": "1002",
                "category_name": "Pets",
                "description": "This will exclude any content that TikTok deems as unfair treatment to animals or pets, such as sensitive issues like animal testing, animal products used in fashion or pet illness, or demise-related content which may impact your campaign performance.",
                "supported_regions": [
                    "US",
                    "GB",
                    "AU",
                    "CA"
                ]
            }
        ]
    }
}

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