Search Goods Info — API TikTok Shop

tiktok.fbt.202607.goods.search

Request

Địa chỉ

Xác thực & gian hàng

Tham số request

Phân trang

Ví dụ request

curl -s -X POST "https://partner.quantri360.com/v1/tiktok/fbt/202607/goods/search?page_size=10" \
  -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

import requests

KEY = "q360_live_..."  # khóa API của brand
r = requests.post(
    "https://partner.quantri360.com/v1/tiktok/fbt/202607/goods/search",
    params={
        "page_size": 10
    },
    json={},
    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/fbt/202607/goods/search');
for (const [k, v] of Object.entries({"page_size":10})) 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({}),
});
console.log(r.status, await r.json());

<?php
$key = 'q360_live_...'; // khóa API của brand
$url = 'https://partner.quantri360.com/v1/tiktok/fbt/202607/goods/search' . '?' . http_build_query(['page_size' => 10]);
$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, '{}');
$res = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
echo $status, "\n", $res;

Response

Tham số phản hồi (nguyên của TikTok Shop)

Mẫu phản hồi

{
  "code": 0,
  "message": "Success",
  "request_id": "DEMO_REQUEST_FBT_01",
  "data": {
    "next_page_token": "",
    "total_count": 1,
    "goods": [
      {
        "id": "100000000000000101",
        "name": "Mẫu minh họa",
        "barcodes": [
          {
            "code": "SKU-MAU-01",
            "type": "MERCHANT_SKU_ID"
          }
        ],
        "reference_code": "HANG-MAU-01",
        "image_url": "https://example.com/minh-hoa/anh.png",
        "merchant_declaration_info": {
          "weight": {
            "value": "350",
            "unit": "GRAM"
          },
          "dimension": {
            "width": "15",
            "length": "25",
            "height": "10",
            "unit": "CENTIMETER"
          }
        },
        "warehouse_confirmation_info": {
          "weight": {
            "value": "350",
            "unit": "GRAM"
          },
          "dimension": {
            "width": "15",
            "length": "25",
            "height": "10",
            "unit": "CENTIMETER"
          }
        },
        "skus": [
          {
            "id": "100000000000000101",
            "name": "Mẫu minh họa",
            "image_url": "https://example.com/minh-hoa/anh.png",
            "product": {
              "id": "100000000000000101",
              "name": "Mẫu minh họa",
              "image_url": "https://example.com/minh-hoa/anh.png"
            },
            "regions": [
              "US"
            ],
            "matched": true
          }
        ],
        "lot_expiration_info": {
          "is_lot_control": true,
          "is_expiration_management": true,
          "shelf_life_days": 365,
          "inbound_cutoff_days": 90,
          "expiration_alert_days": 60,
          "sales_cutoff_days": 30,
          "handling_method": "STORE_UNITS"
        },
        "is_hazmat": true,
        "hazmat_info": {
          "hazmat_type": "BATTERY",
          "battery_extra_info": {
            "battery_type": "LITHIUM_ION",
            "battery_packaging_type": "STANDALONE",
            "total_battery_weight": "50",
            "total_battery_weight_unit": "GRAM",
            "total_battery_capacity": "10",
            "battery_count_per_package": "1",
            "is_need_un_38_3_test": false,
            "un_38_3_test_file_url": "https://example.com/minh-hoa/tep.pdf",
            "total_battery_capacity_unit": "WATT_HOURS"
          },
          "dg_class": "CLASS_9",
          "dg_uncode": "UN3481",
          "msds_file_url": "https://example.com/minh-hoa/tep.pdf"
        },
        "sioc_approval_status": "SIOC_APPROVAL_STATUS_INVALID",
        "hazmat_approval_status": "APPROVAL_STATUS_INVALID",
        "bulky_item_attribute": {
          "is_bulky_item": false,
          "is_bulky_item_accessories": false
        },
        "goods_safety_attributes": {
          "is_fragile": false,
          "is_liquid": false,
          "is_sharp": false
        },
        "is_sioc": true,
        "sioc_attribute": {
          "sioc_files": [
            {
              "sioc_certification_url": "https://example.com/minh-hoa/tep.pdf",
              "sioc_file_type": "DOCUMENT"
            }
          ]
        }
      }
    ]
  }
}

Bắt đầu dùng

1. Đăng ký tài khoản Partner
2. Mở loại dữ liệu thuộc nhóm Đơn hàng ở trang nền tảng
3. Tạo API key (tick kênh TikTok Shop)
4. Gọi theo ví dụ ở trên