Developer resources

Upload products via a JSON schema — TikTok Business API

Upload products via a JSON schema · 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

Upload products via a JSON schema

POST/catalog/product/upload/Via 360: POST https://partner.quantri360.com/v1/tiktok_business/catalog/product/upload/

Write endpoint — changes data on TikTok Business. The key must be created with "Allow write API calls" ticked, otherwise you get 403 write_not_allowed. Every call is logged.

Description

Use this endpoint to upload products to the catalog in batch and you can upload up to 5000 products at a time. The system will enter the products specified in the request asynchronously, and at the same time, you will get a task processing ID, feed_log_id. With this ID you can view the processing status via the /catalog/product/log/ endpoint.

Different from /catalog/product/file/, this endpoint is mainly used for uploading a small number of products and updating some fields. For product catalogs with high update frequency (higher than once a day), it is recommended to upload products with this endpoint.

> Note

The SKU is unique under the same E-commerce catalog and only belongs to a certain feed. All operations on a SKU need to be performed under the feed to which it belongs.
You can make up to 1,000 requests per hour for each product catalog.
With this endpoint, products are updated incrementally. Data for existing products will not be replaced unless you upload the same product again.
Product images must be 500x500 px or larger in size. Otherwise, the product will not be approved. For details, see Product Image Requirements.

Request

Endpoint

POST https://partner.quantri360.com/v1/tiktok_business/catalog/product/upload/

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	body	string	Yes	Business Center ID.
catalog_id	body	string	Yes	Catalog ID.
feed_id	body	string	No	Catalog feeds ID.
products	body	object[]	Yes	List of products. For the data fields in this array, see the "`products` object array parameters" section below.

Request examples

curl -s -X POST "https://partner.quantri360.com/v1/tiktok_business/catalog/product/upload/" \
  -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/json" \
  -d '{"bc_id":"","catalog_id":"","products":[]}'

Python

import requests

KEY = "q360_live_..."  # khóa API của brand
r = requests.post(
    "https://partner.quantri360.com/v1/tiktok_business/catalog/product/upload/",
    params={},
    json={
        "bc_id": "",
        "catalog_id": "",
        "products": []
    },
    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/product/upload/');
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: 'POST',
  headers: { Authorization: `Bearer ${KEY}`, 'Content-Type': 'application/json' },
  body: JSON.stringify({"bc_id":"","catalog_id":"","products":[]}),
});
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/product/upload/' . '?' . http_build_query([]);
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, ['Authorization: Bearer ' . $key, 'Content-Type: application/json']);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, '{"bc_id":"","catalog_id":"","products":[]}');
$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 Codes.
message	string	Response message. For details, see Appendix - Return Codes.
request_id	string	The log ID of the request, which uniquely identifies a request.
data	object	Returned data.
feed_log_id	string	Catalog handling log ID.

Response sample

{
    "message": "OK",
    "code": 0,
    "data": {
        "feed_log_id": "{{feed_log_id}}"
    },
    "request_id": "{{request_id}}"
}

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