Search Size Charts — TikTok Shop API

tiktok.product.202407.sizecharts.search

POST/product/202407/sizecharts/searchVia 360: POST https://partner.quantri360.com/v1/tiktok/product/202407/sizecharts/search

Description

Tìm bảng size của gian hàng (mẫu dùng lại nhiều sản phẩm, hoặc bảng gắn riêng từng sản phẩm): ảnh bảng size, ngành áp dụng, bảng số đo dạng hàng / cột. Dù là POST, API này CHỈ ĐỌC. Dùng để lấy template_id gắn vào sản phẩm khi đăng.

Bỏ trống size_chart_mode chỉ trả mẫu dùng lại — gian hàng chưa tạo mẫu nào nhận total_count: 0 dù sản phẩm vẫn có bảng size riêng; muốn xem bảng của sản phẩm gửi PRODUCT_SCOPED.
API cấp người bán: 360 tự bỏ shop_cipher khi gọi.

Request

Endpoint

POST https://partner.quantri360.com/v1/tiktok/product/202407/sizecharts/search

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	100001	Gian 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.

Request parameters

Name	In	Type	Required	Sample	Description
page_size	query	int	Yes	20	1–100.
page_token	query	string	No		`next_page_token` của trang trước.
locales	query	string	No	vi-VN	Ngôn ngữ, cách dấu phẩy.
size_chart_mode	body	string	No	PRODUCT_SCOPED	`REUSABLE_TEMPLATE` (mẫu dùng lại) · `PRODUCT_SCOPED` (bảng riêng của từng sản phẩm). Bỏ trống = chỉ mẫu dùng lại.
ids	body	string[]	No		Lọc theo `template_id`, tối đa 50 (ưu tiên hơn `keyword`).
keyword	body	string	No		Tìm theo tên mẫu (không áp dụng cho PRODUCT_SCOPED).

Pagination

Lặp khi data.next_page_token khác rỗng, thêm query page_token.

Request examples

curl -s -X POST "https://partner.quantri360.com/v1/tiktok/product/202407/sizecharts/search?platform_shop_id=7494000000000000000&page_size=20" \
  -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/json" \
  -d '{"size_chart_mode":"PRODUCT_SCOPED"}'

Python

import requests

KEY = "q360_live_..."  # khóa API của brand
r = requests.post(
    "https://partner.quantri360.com/v1/tiktok/product/202407/sizecharts/search",
    params={
        "platform_shop_id": "7494000000000000000",
        "page_size": 20
    },
    json={
        "size_chart_mode": "PRODUCT_SCOPED"
    },
    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/202407/sizecharts/search');
for (const [k, v] of Object.entries({"platform_shop_id":"7494000000000000000","page_size":20})) 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({"size_chart_mode":"PRODUCT_SCOPED"}),
});
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/202407/sizecharts/search' . '?' . http_build_query(['platform_shop_id' => '7494000000000000000', 'page_size' => 20]);
$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, '{"size_chart_mode":"PRODUCT_SCOPED"}');
$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 Shop)

Name	Type	Sample	Description
code	int	0	0 = thành công; khác 0 xem message (105001–105003 = token, 360 đã tự làm mới một lần).
message	string	Success	Thông điệp của TikTok.
request_id	string	2025101900000000000000000000	Mã request TikTok.
data	object		Dữ liệu.
total_count	int	0	Có khi tìm mẫu dùng lại.
next_page_token	string
size_chart	object[]		Bảng size (vắng khi không có kết quả).
template_id	string	7650815603297306376	Mã bảng — gửi `size_chart.template.id` khi tạo sản phẩm.
template_name	string		Tên (bảng PRODUCT_SCOPED có tên tự sinh).
size_chart_mode	string	PRODUCT_SCOPED
target_regions	string[]	["VN"]
related_category_ids	string[]		Ngành lá áp dụng.
images	object[]		[{uri, url, locale}].
size_chart_datas	object[]		Bảng số đo theo ngôn ngữ: [{locale, size_chart_data{table{headers[{id,name}], rows[{cells[{value}]}]}, measurement_type `BODY_MEASUREMENTS`\|`PRODUCT_MEASUREMENTS`\|`GENERIC_MEASUREMENTS`, unit_system `METRIC`\|`IMPERIAL`, is_one_size, size_types, description}}].

Response sample

{
  "code": 0,
  "message": "Success",
  "request_id": "2026102917…",
  "data": {
    "next_page_token": "cGFnZV9udW1iZXI9Mg==",
    "size_chart": [
      {
        "template_id": "7650815603297306376",
        "template_name": "image_to_table_1734767715006646040",
        "size_chart_mode": "PRODUCT_SCOPED",
        "target_regions": [
          "VN"
        ],
        "related_category_ids": [
          "601270",
          "601271",
          "601281"
        ],
        "images": [
          {
            "locale": "vi",
            "uri": "tos-alisg-i-aphluv4xwc-sg/cd8771188b744b94a4fe7aeeea0e60a1",
            "url": "https://p16-oec-sg.ibyteimg.com/…"
          }
        ],
        "size_chart_datas": [
          {
            "locale": "vi",
            "size_chart_data": {
              "description": "",
              "is_one_size": false,
              "measurement_type": "BODY_MEASUREMENTS",
              "unit_system": "METRIC",
              "size_types": [
                "size_chart_size_type_regular"
              ],
              "table": {
                "headers": [
                  {
                    "id": "size_chart_size_system_size",
                    "name": "Kích cỡ"
                  },
                  {
                    "id": "",
                    "name": "VÒNG NGỰC (cm)"
                  },
                  {
                    "id": "",
                    "name": "CHIỀU CAO (cm)"
                  }
                ],
                "rows": [
                  {
                    "cells": [
                      {
                        "value": "S"
                      },
                      {
                        "value": "74 - 77"
                      },
                      {
                        "value": "146 - 148"
                      }
                    ]
                  },
                  {
                    "cells": [
                      {
                        "value": "M"
                      },
                      {
                        "value": "83 - 87"
                      },
                      {
                        "value": "152 - 154"
                      }
                    ]
                  }
                ]
              }
            }
          }
        ]
      }
    ]
  }
}

Get started

Sign up for Partner
Enable a data type of the Sản phẩm group on the platform page
Create an API key (tick the TikTok Shop channel)
Call it as in the examples above