VI | EN
Message us on Messenger
Developer resources

Get the catalog video handling log — TikTok Business API

Get the catalog video handling log · 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.

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

NameInTypeSampleDescription
AuthorizationheaderheaderBearer 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_idquerystring7000000000000000001Tà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

NameInTypeRequiredSampleDescription
bc_idquerystringYesBusiness Center ID. To obtain the list of Business Centers that you have access to, use /bc/get/.
catalog_idquerystringYesCatalog 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_idquerystringYesCatalog video handling log ID. To upload catalog videos and obtain the log ID, use /catalog/video/file/.
languagequerystringNoSupported 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)

NameTypeSampleDescription
codenumberResponse code. For the complete list of response codes and descriptions, see Appendix-Return Code.
messagestringResponse message. For details, see Appendix - Return Codes.
request_idstringThe log ID of a request, which uniquely identifies the request.
dataobjectReturned data.
video_feed_logobjectVideo handling results.
catalog_idstringCatalog ID.
feed_idstringFeed ID.
add_countnumberTotal number of new videos.
update_countnumberTotal number of videos modified. Note: The value of this field will always be 0.
delete_countnumberTotal number of videos deleted.
error_countnumberNumber of errors.
warn_countnumberNumber of warnings.
process_statusstringProcessing status. Enum values:`PROCESSING`, `SUCCESS`,`FAILED`, `WAITING`.
start_timestringStart 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_timestringEnd 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_dataobjectDetailed processing information.
download_pathobjectFile download address with all error and warning messages. The key is language, and the value is file address.
error_affected_videosobject[]Error message.
affected_video_countnumberNumber of videos affected.
affected_video_item_listobject[]List of affected videos, showing only the first five items.
indexnumberIndex 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_namestringThe name of the video.
video_linkstringThe URL of the video file. Example:
sku_id_liststringThe SKU ID list of E-commerce catalog products to associate the video (`video_link`) with. Example: `"SKU_ID_1, SKU_ID_2"`.
descriptionstringA short description of the video.
categorystringThe product category for the video. Example: Apparel & Accessories> Clothing> Shirts.
fieldstringThe field with issue.
issuestringIssue details.
suggestionstringSuggestions for solving the issue.
warn_affected_videosobject[]Warning message.
affected_video_countnumberNumber of products affected.
affected_video_item_listobject[]List of affected items, showing only the first five items.
indexnumberIndex 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_namestringThe name of the video.
video_linkstringThe URL of the video file. Example:
sku_id_liststringThe SKU ID list of E-commerce catalog products to associate the video (`video_link`) with. Example: `"SKU_ID_1, SKU_ID_2"`.
descriptionstringA short description of the video.
categorystringThe product category for the video. Example: Apparel & Accessories> Clothing> Shirts.
fieldstringThe field with issue.
issuestringIssue details.
suggestionstringSuggestions 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

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