VI | EN
Nhắn Messenger
Dành cho developer

Xem chi tiết sản phẩm theo mã — API TikTok Shop

tiktok.product.202309.products.product_id · gọi qua Quantri360 bằng một API key cho chính tài khoản / tài sản bạn đã kết nối và ủy quyền — 360 lo việc ký request và làm mới phiên đăng nhập bạn đã cấp.

tiktok.product.202309.products.product_id

GET/product/202309/products/{product_id}Gọi qua 360: GET https://partner.quantri360.com/v1/tiktok/product/202309/products/{product_id}
Mô tả API

Chi tiết đầy đủ một sản phẩm: tiêu đề, mô tả HTML, ảnh, video, ngành (chuỗi cha → lá), thương hiệu, thuộc tính, cân nặng / kích thước, bảng size, trạng thái duyệt và từng SKU (giá, tồn theo kho, thuộc tính bán hàng, seller_sku).

  • Ảnh / video trả link có hạn dùng — lưu uri (ảnh) hoặc id (video), không lưu link.
  • Một sản phẩm có thể đang SELLER_DEACTIVATED mà vẫn có đơn trong kỳ phân tích (đơn đặt trước lúc tắt).

Request

Địa chỉ

GET https://partner.quantri360.com/v1/tiktok/product/202309/products/{product_id}

Xác thực & gian hàng

TênVị tríKiểuMẫuMô tả
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_idquerystring100001Gian hàng (lấy ở GET /v1/platforms → shops[].platform_shop_id). BẮT BUỘC khi brand có > 1 gian hàng trên nền tảng; 360 bỏ tham số này trước khi chuyển tiếp.

Tham số request

TênVị tríKiểuBắt buộcMẫuMô tả
product_idpathstringCó1729000000000000001Mã sản phẩm.
return_under_review_versionqueryboolKhôngfalsetrue = trả bản đang chờ duyệt (nếu có).

Ví dụ request

curl -s "https://partner.quantri360.com/v1/tiktok/product/202309/products/1729000000000000001?platform_shop_id=7494000000000000000" \
  -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/product/202309/products/1729000000000000001",
    params={
        "platform_shop_id": "7494000000000000000"
    },
    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/product/202309/products/1729000000000000001');
for (const [k, v] of Object.entries({"platform_shop_id":"7494000000000000000"})) 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/product/202309/products/1729000000000000001' . '?' . http_build_query(['platform_shop_id' => '7494000000000000000']);
$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

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

TênKiểuMẫuMô tả
codeint00 = thành công; khác 0 xem message (105001–105003 = token, 360 đã tự làm mới một lần).
messagestringSuccessThông điệp của TikTok.
request_idstringYEU_CAU_MINH_HOAMã request TikTok.
dataobjectDữ liệu.
idstring900000000000000001Mã định danh.
titlestringÁo thun cotton cổ tròn minh họaTiêu đề.
descriptionstring<p>Sản phẩm minh họa.</p>HTML (ảnh trong mô tả là ảnh host TikTok).
statusstringACTIVATE`DRAFT` · `PENDING` · `FAILED` · `ACTIVATE` · `SELLER_DEACTIVATED` · `PLATFORM_DEACTIVATED` · `FREEZE` · `DELETED`.
auditobject{status (`APPROVED`…), pre_approved_reasons, not_submitted_reasons}.
not_submitted_reasonsobject[]Lý do chưa gửi duyệt.
pre_approved_reasonsobject[]Lý do được chấp thuận trước.
statusstringMinh họaTrạng thái.
category_chainsobject[]Ngành từ gốc tới lá: [{id, parent_id, local_name, is_leaf}].
idstring900000000000000001Mã định danh.
is_leafbooleanfalseCó phải ngành hàng lá hay không.
local_namestringMinh họaTên ngành hàng theo ngôn ngữ.
parent_idstring900000000000000001Mã ngành hàng cha.
brandobject{id, name}.
idstring900000000000000001Mã định danh.
namestringMinh họaTên.
main_imagesobject[][{uri, urls[], thumb_urls[], width, height}] — `uri` dùng khi sửa sản phẩm.
heightnumber800Chiều cao.
thumb_urlsstring[]Danh sách ảnh thu nhỏ.
uristringanh-minh-hoaURI ảnh đã tải lên.
urlsstring[]Danh sách địa chỉ hiển thị.
widthnumber800Chiều rộng.
videoobject{id, url, cover_url, format, width, height, size}.
product_attributesobject[][{id, name, values[{id, name}]}].
idstring900000000000000001Mã định danh.
namestringMinh họaTên.
valuesobject[]Các giá trị.
idstring900000000000000001Mã định danh.
namestringMinh họaTên.
package_weightobject{value (chuỗi), unit}.
unitstringCENTIMETERĐơn vị.
valuestringMinh họaGiá trị.
package_dimensionsobject{length, width, height, unit}.
heightstringMinh họaChiều cao.
lengthstringMinh họaChiều dài.
unitstringCENTIMETERĐơn vị.
widthstringMinh họaChiều rộng.
size_chartobject{image{uri, urls…}} hoặc {template{id}}.
imageobjectẢnh.
heightnumber800Chiều cao.
thumb_urlsstring[]Danh sách ảnh thu nhỏ.
uristringanh-minh-hoaURI ảnh đã tải lên.
urlsstring[]Danh sách địa chỉ hiển thị.
widthnumber800Chiều rộng.
is_cod_allowedboolfalseCho phép thanh toán khi nhận hàng.
create_timeint1793494800Unix giây.
update_timeint1793494800Unix giây.
skusobject[]Biến thể.
idstring900000000000000001Mã SKU.
seller_skustringSKU-MAU-01SKU người bán.
priceobject{currency, sale_price, tax_exclusive_price} — chuỗi số.
currencystringVNDMã tiền tệ.
sale_pricestring150000Giá hiển thị trước giảm giá.
tax_exclusive_pricestring150000Giá chưa gồm thuế.
inventoryobject[]Tồn theo kho [{warehouse_id, quantity}].
quantitynumber1Số lượng.
warehouse_idstring900000000000000001Mã kho.
sales_attributesobject[][{id, name, value_id, value_name, sku_img}] — vd Màu sắc / Kích cỡ.
idstring900000000000000001Mã định danh.
namestringMinh họaTên.
sku_imgobjectẢnh biến thể.
heightnumber800Chiều cao.
thumb_urls…[]Danh sách ảnh thu nhỏ.
uristringanh-minh-hoaURI ảnh đã tải lên.
urls…[]Danh sách địa chỉ hiển thị.
widthnumber800Chiều rộng.
value_idstring900000000000000001Mã giá trị.
value_namestringMinh họaTên giá trị.
status_infoobject{status} của SKU.
statusstringMinh họaTrạng thái.
sku_weightobjectKhối lượng SKU.
unitstringCENTIMETERĐơn vị.
valuestringMinh họaGiá trị.
sku_dimensionsobjectKích thước SKU.
heightstringMinh họaChiều cao.
lengthstringMinh họaChiều dài.
unitstringCENTIMETERĐơn vị.
widthstringMinh họaChiều rộng.
global_listing_policyobjectChính sách đăng toàn cầu.
inventory_typestringMinh họaLoại tồn kho.
price_syncbooleanfalseĐồng bộ giá.
has_draftbooleanfalseCó bản nháp.
is_not_for_salebooleanfalseSản phẩm không để bán.
is_pre_ownedbooleanfalseSản phẩm đã qua sử dụng.
is_replicatedbooleanfalseSản phẩm đã được sao chép.
manufacturer_idsobject[]Danh sách mã nhà sản xuất.
product_statusstringMinh họaTrạng thái sản phẩm.
product_tagsobject[]Các nhãn sản phẩm.
recommended_categoriesobject[]Các ngành hàng được gợi ý.
responsible_person_idsobject[]Danh sách mã người chịu trách nhiệm.
selling_formatstringMinh họaHình thức bán.
shipping_insurance_requirementstringMinh họaYêu cầu bảo hiểm vận chuyển.
subscribe_infoobjectThông tin mua định kỳ.
subscribe_promotion_configobject[]Cấu hình ưu đãi mua định kỳ.
discount_levelstringMinh họaMức giảm giá.
subscribe_statusstringMinh họaTrạng thái mua định kỳ.
support_subscribebooleanfalseHỗ trợ mua định kỳ.

Mẫu phản hồi

{
  "code": 0,
  "message": "Success",
  "request_id": "YEU_CAU_MINH_HOA",
  "data": {
    "id": "900000000000000001",
    "title": "Áo thun cotton cổ tròn minh họa",
    "description": "<p>Sản phẩm minh họa.</p>",
    "status": "ACTIVATE",
    "audit": {
      "not_submitted_reasons": [],
      "pre_approved_reasons": [],
      "status": "Minh họa"
    },
    "category_chains": [
      {
        "id": "900000000000000001",
        "is_leaf": false,
        "local_name": "Minh họa",
        "parent_id": "900000000000000001"
      }
    ],
    "brand": {
      "id": "900000000000000001",
      "name": "Minh họa"
    },
    "main_images": [
      {
        "height": 800,
        "thumb_urls": [
          ""
        ],
        "uri": "anh-minh-hoa",
        "urls": [
          ""
        ],
        "width": 800
      }
    ],
    "video": {},
    "product_attributes": [
      {
        "id": "900000000000000001",
        "name": "Minh họa",
        "values": [
          {
            "id": "900000000000000001",
            "name": "Minh họa"
          }
        ]
      }
    ],
    "package_weight": {
      "unit": "KILOGRAM",
      "value": "0.5"
    },
    "package_dimensions": {
      "height": "Minh họa",
      "length": "Minh họa",
      "unit": "CENTIMETER",
      "width": "Minh họa"
    },
    "size_chart": {
      "image": {
        "height": 800,
        "thumb_urls": [
          ""
        ],
        "uri": "anh-minh-hoa",
        "urls": [
          ""
        ],
        "width": 800
      }
    },
    "is_cod_allowed": false,
    "create_time": 1793494800,
    "update_time": 1793494800,
    "skus": [
      {
        "id": "900000000000000001",
        "seller_sku": "SKU-MAU-01",
        "price": {
          "currency": "VND",
          "sale_price": "150000",
          "tax_exclusive_price": "150000"
        },
        "inventory": [
          {
            "quantity": 1,
            "warehouse_id": "900000000000000001"
          }
        ],
        "sales_attributes": [
          {
            "id": "900000000000000001",
            "name": "Minh họa",
            "sku_img": {
              "height": 800,
              "thumb_urls": [
                ""
              ],
              "uri": "anh-minh-hoa",
              "urls": [
                ""
              ],
              "width": 800
            },
            "value_id": "900000000000000001",
            "value_name": "Minh họa"
          }
        ],
        "status_info": {
          "status": "Minh họa"
        },
        "sku_weight": {
          "unit": "KILOGRAM",
          "value": "0.5"
        },
        "sku_dimensions": {
          "height": "Minh họa",
          "length": "Minh họa",
          "unit": "CENTIMETER",
          "width": "Minh họa"
        },
        "global_listing_policy": {
          "inventory_type": "Minh họa",
          "price_sync": false
        }
      }
    ],
    "has_draft": false,
    "is_not_for_sale": false,
    "is_pre_owned": false,
    "is_replicated": false,
    "manufacturer_ids": [],
    "product_status": "Minh họa",
    "product_tags": [],
    "recommended_categories": [],
    "responsible_person_ids": [],
    "selling_format": "Minh họa",
    "shipping_insurance_requirement": "Minh họa",
    "subscribe_info": {
      "subscribe_promotion_config": [
        {
          "discount_level": "Minh họa"
        }
      ],
      "subscribe_status": "Minh họa",
      "support_subscribe": false
    }
  }
}

Bắt đầu dùng

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