Get the product handling log — TikTok Business API

Get the product handling log

Request

Endpoint

Authentication & shop

Request parameters

Request examples

curl -s "https://partner.quantri360.com/v1/tiktok_business/catalog/product/log/?bc_id=&catalog_id=&feed_log_id=" \
  -H "Authorization: Bearer $KEY"

import requests

KEY = "q360_live_..."  # khóa API của brand
r = requests.get(
    "https://partner.quantri360.com/v1/tiktok_business/catalog/product/log/",
    params={
        "bc_id": "",
        "catalog_id": "",
        "feed_log_id": ""
    },
    headers={"Authorization": f"Bearer {KEY}"},
    timeout=60,
)
print(r.status_code)
print(r.json())

const KEY = 'q360_live_...'; // khóa API của brand
const url = new URL('https://partner.quantri360.com/v1/tiktok_business/catalog/product/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
$key = 'q360_live_...'; // khóa API của brand
$url = 'https://partner.quantri360.com/v1/tiktok_business/catalog/product/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)

Response sample

HTTPS/1.1 200 OK
{
"message": "OK",
"code": 0,
"data": {
    "product_feed_log": {
        "process_status": "SUCCESS",
        "update_mode": "INCREASE",
        "error_count": 0,
        "add_count": 0,
        "feeds_id": 2335,
        "warn_count": 1,
        "delete_count": 0,
        "feed_log_data": {
            "error_affected_products": null,
            "warn_affected_products": [
                {
                    "suggestion": "The \"age_group\" field is using an invalid value. Supported values only include: newborn/infant/toddler/kids/adult",
                    "issue": "Invalid value: age_group",
                    "field": "age_group",
                    "affected_product_count": 1,
                    "affected_product_item_list": [
                        {
                            "index": 3,
                            "sku_id": "tiktok_item_12424",
                            "description": "qgs test product description",
                            "title": "qgs test product",
                            "value": "None",
                            "product_url": "https://ads.tiktok.com"
                        }
                    ]
                },
                {
                    "suggestion": "The \"gender\" field is using an invalid value. Supported values only include: male/female/unisex",
                    "issue": "Invalid value: gender",
                    "field": "gender",
                    "affected_product_count": 1,
                    "affected_product_item_list": [
                        {
                            "index": 3,
                            "sku_id": "tiktok_item_12424",
                            "description": "qgs test product description",
                            "title": "qgs test product",
                            "value": "None",
                            "product_url": "https://ads.tiktok.com"
                        }
                    ]
                }
            ],
            "download_path": {
                "ru": "http://tosv.boei18n.byted.org/obj/dpafeed/6865965734837634822_73472_ru.csv",
                "fr": "http://tosv.boei18n.byted.org/obj/dpafeed/6865965734837634822_73472_fr.csv",
                "en": "http://tosv.boei18n.byted.org/obj/dpafeed/6865965734837634822_73472_en.csv",
                "ms": "http://tosv.boei18n.byted.org/obj/dpafeed/6865965734837634822_73472_ms.csv",
                "ko": "http://tosv.boei18n.byted.org/obj/dpafeed/6865965734837634822_73472_ko.csv",
                "vi": "http://tosv.boei18n.byted.org/obj/dpafeed/6865965734837634822_73472_vi.csv",
                "de": "http://tosv.boei18n.byted.org/obj/dpafeed/6865965734837634822_73472_de.csv",
                "tr": "http://tosv.boei18n.byted.org/obj/dpafeed/6865965734837634822_73472_tr.csv",
                "it": "http://tosv.boei18n.byted.org/obj/dpafeed/6865965734837634822_73472_it.csv",
                "zh-CN": "http://tosv.boei18n.byted.org/obj/dpafeed/6865965734837634822_73472_zh-CN.csv",
                "hi-IN": "http://tosv.boei18n.byted.org/obj/dpafeed/6865965734837634822_73472_hi-IN.csv",
                "th": "http://tosv.boei18n.byted.org/obj/dpafeed/6865965734837634822_73472_th.csv",
                "ja-JP": "http://tosv.boei18n.byted.org/obj/dpafeed/6865965734837634822_73472_ja-JP.csv",
                "id": "http://tosv.boei18n.byted.org/obj/dpafeed/6865965734837634822_73472_id.csv",
                "es": "http://tosv.boei18n.byted.org/obj/dpafeed/6865965734837634822_73472_es.csv"
            }
        },
        "catalog_id": 6865965734837634822,
        "update_count": 2,
        "start_time": "2020-09-14 05:15:09",
        "end_time": "2020-09-14 05:15:09"
    }
},
"request_id": "2020091406394701023125321410044"
}
(/code);

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