Developer resources

Get trending catalog product categories — TikTok Business API

Get trending catalog product 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 trending catalog product categories

GET/catalog/insight/category/get/Via 360: GET https://partner.quantri360.com/v1/tiktok_business/catalog/insight/category/get/

Description

Use this endpoint to retrieve the number of products in your E-commerce catalog that match the top 50 trending product categories based on user engagement on TikTok, along with the product availability percentage.

>Note

Catalog Product Insights become available 24 hours after you have uploaded a minimum of 20 products to your E-commerce catalog.
The insights are refreshed daily at around 4:00 AM UTC time.

Request

Endpoint

GET https://partner.quantri360.com/v1/tiktok_business/catalog/insight/category/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	Description
bc_id	query	string	Yes	Business Center ID. To obtain the list of Business Centers that you have access to, use /bc/get/.
catalog_id	query	string	Yes	Catalog ID. The catalog needs to be an E-commerce catalog that contains at least 20 products. To obtain the list of E-commerce catalogs within a Business Center, use /catalog/get/ and retrieve `catalog_id` values with `catalog_type` as `ECOM`. To verify that the catalog contains at least 20 products, use /catalog/overview/ and check whether the sum of the values of the returned `approved`, `rejected`, and `processing` fields is equal to or greater than 20.
filtering	query	object	No	Filtering conditions.

Request examples

curl -s "https://partner.quantri360.com/v1/tiktok_business/catalog/insight/category/get/?bc_id=&catalog_id=" \
  -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/catalog/insight/category/get/",
    params={
        "bc_id": "",
        "catalog_id": ""
    },
    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/catalog/insight/category/get/');
for (const [k, v] of Object.entries({"bc_id":"","catalog_id":""})) 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/catalog/insight/category/get/' . '?' . http_build_query(['bc_id' => '', 'catalog_id' => '']);
$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 response codes and descriptions, see Appendix-Return Code.
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.
category_insights	object[]	The list of the top 50 trending product categories on TikTok, sorted in descending order by popularity. For instance, the first item in the list is ranked 1st, indicating the most popular product category, and the second item is ranked 2nd, indicating the second most popular product category.
category_id	string	The TikTok product category ID assigned to the product, consisting of three levels separated by the number sign (#), in the format of `"level_id_1#level_id_2#level_id_3"`. Example: `601152#842248#601302`.
level_info	object	Details of the levels that the category belongs to.
level_id_1	string	The ID of the level-1 TikTok product category.
level_name_1	string	The name of the level-1 TikTok product category.
level_id_2	string	The ID of the level-2 TikTok product category.
level_name_3	string	The name of the level-2 TikTok product category.
level_id_3	string	The ID of the level-3 TikTok product category.
level_name_3	string	The name of the level-3 TikTok product category.
total_product_count	integer	The number of products in the catalog (`catalog_id`) that match the product category (`category_id`).
product_availability_rate	float	The total percentage of matching products in this category that are currently in stock in the catalog. If the value is too low, you can use /catalog/product/update/ to update the `availability` of the relevant products to `IN_STOCK`.

Response sample

HTTPS/1.1 200 OK
{
    "code": 0,
    "message": "OK",
    "request_id": "{{request_id}}",
    "data": {
        "category_insights": [
            {
                "category_id": "601352#900488#900872",
                "level_info": {
                    "level_id_1": "601352",
                    "level_id_2": "900488",
                    "level_id_3": "900872",
                    "level_name_1": "Shoes",
                    "level_name_2": "Women's Shoes",
                    "level_name_3": "Trainers"
                },
                "product_availability_rate": 0.6666666666666667,
                "total_product_count": 3
            },
            ...
            {
                "category_id": "605248#905608#605268",
                "level_info": {
                    "level_id_1": "605248",
                    "level_id_2": "905608",
                    "level_id_3": "605268",
                    "level_name_1": "Fashion Accessories",
                    "level_name_2": "Jewellery & Accessories",
                    "level_name_3": "Earrings"
                },
                "product_availability_rate": 0.375,
                "total_product_count": 8
            }
        ]
    }
}

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