Get the catalog video handling log
GET/catalog/video/log/Via 360: GET https://partner.quantri360.com/v1/tiktok_business/catalog/video/log/
Description
Use this endpoint to check if the catalog videos are uploaded successfully, and what to do if the upload fails.
Request
Endpoint
GET https://partner.quantri360.com/v1/tiktok_business/catalog/video/log/
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 |
|---|---|---|---|---|---|
| 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.
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.
You need to have Catalog Management or Ad Promotion permission for the catalog. To obtain the catalogs for which you have Catalog Management or Ad Promotion permission, use /bc/asset/get/. Set asset_type to CATALOG to retrieve asset_id values with catalog_role as ADMIN or AD_PROMOTE. | |
| feed_log_id | query | string | Yes | Catalog video handling log ID. To upload catalog videos and obtain the log ID, use /catalog/video/file/. | |
| language | query | string | No | Supported languages.
Enum values:
- en: English
- zh-CN: Chinese
- ja-JP: Japanese
- de: German
- es: Spanish
- fr: French
- hi-IN: Hindi (India)
- id: Indonesian
- it: Italian
- ko: Korean
- ms: Malay
- ru: Russian
- th: Thai
- tr: Turkish
- vi: Vietnamese
Default value: en. |
Request examples
curl -s "https://partner.quantri360.com/v1/tiktok_business/catalog/video/log/?bc_id=&catalog_id=&feed_log_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/video/log/",
params={
"bc_id": "",
"catalog_id": "",
"feed_log_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/video/log/');
for (const [k, v] of Object.entries({"bc_id":"","catalog_id":"","feed_log_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/video/log/' . '?' . http_build_query(['bc_id' => '', 'catalog_id' => '', 'feed_log_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 | Sample | 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. | |
| video_feed_log | object | Video handling results. | |
| catalog_id | string | Catalog ID. | |
| feed_id | string | Feed ID. | |
| add_count | number | Total number of new videos. | |
| update_count | number | Total number of videos modified. Note: The value of this field will always be 0. | |
| delete_count | number | Total number of videos deleted. | |
| error_count | number | Number of errors. | |
| warn_count | number | Number of warnings. | |
| process_status | string | Processing status. Enum values:`PROCESSING`, `SUCCESS`,`FAILED`, `WAITING`. | |
| start_time | string | Start time of the video handling task, in the format of `YYYY-MM-DD HH:MM:SS` (UTC+0). Example: 2024-01-01 00:00:00. | |
| end_time | string | End time of the video handling task, in the format of `YYYY-MM-DD HH:MM:SS` (UTC+0). Example: 2024-01-01 00:00:00. | |
| feed_log_data | object | Detailed processing information. | |
| download_path | object | File download address with all error and warning messages. The key is language, and the value is file address. | |
| error_affected_videos | object[] | Error message. | |
| affected_video_count | number | Number of videos affected. | |
| affected_video_item_list | object[] | List of affected videos, showing only the first five items. | |
| index | number | Index that identifies the position of the video among the videos you uploaded. For example, an index of `2` represents the first video you uploaded through /catalog/video/file/, listed in the second row of the CSV file after the header row. | |
| video_name | string | The name of the video. | |
| video_link | string | The URL of the video file. Example: | |
| sku_id_list | string | The SKU ID list of E-commerce catalog products to associate the video (`video_link`) with. Example: `"SKU_ID_1, SKU_ID_2"`. | |
| description | string | A short description of the video. | |
| category | string | The product category for the video. Example: Apparel & Accessories> Clothing> Shirts. | |
| field | string | The field with issue. | |
| issue | string | Issue details. | |
| suggestion | string | Suggestions for solving the issue. | |
| warn_affected_videos | object[] | Warning message. | |
| affected_video_count | number | Number of products affected. | |
| affected_video_item_list | object[] | List of affected items, showing only the first five items. | |
| index | number | Index that identifies the position of the video among the videos you uploaded. For example, an index of `2` represents the first video you uploaded through /catalog/video/file/, listed in the second row of the CSV file after the header row. | |
| video_name | string | The name of the video. | |
| video_link | string | The URL of the video file. Example: | |
| sku_id_list | string | The SKU ID list of E-commerce catalog products to associate the video (`video_link`) with. Example: `"SKU_ID_1, SKU_ID_2"`. | |
| description | string | A short description of the video. | |
| category | string | The product category for the video. Example: Apparel & Accessories> Clothing> Shirts. | |
| field | string | The field with issue. | |
| issue | string | Issue details. | |
| suggestion | string | Suggestions for solving the issue. |
Response sample
HTTPS/1.1 200 OK
{
"code": 0,
"message": "OK",
"request_id": "{{request_id}}",
"data": {
"video_feed_log": {
"update_mode": null,
"process_status": "SUCCESS",
"catalog_id": "{{catalog_id}}",
"delete_count": 0,
"feed_id": "{{feed_id}}",
"start_time": "{{start_time}}",
"error_count": 0,
"feed_log_data": {
"error_affected_videos": null,
"download_path": {},
"warn_affected_videos": null
},
"end_time": "{{end_time}}",
"warn_count": 0,
"add_count": 1,
"update_count": 0
}
}
}
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