VI | EN
Message us on Messenger
Developer resources

Check Product Listing — TikTok Shop API

tiktok.product.202309.products.listing_check · 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.

tiktok.product.202309.products.listing_check

POST/product/202309/products/listing_checkVia 360: POST https://partner.quantri360.com/v1/tiktok/product/202309/products/listing_check
Description

Kiểm tra thông tin sản phẩm trước khi đăng để tìm lỗi cần sửa; nội dung phải dùng ngôn ngữ của thị trường đích.

  • Gọi qua /v1/tiktok/product/202309/products/listing_check với Authorization: Bearer <key>; dùng platform_shop_id khi có nhiều shop. 360 tự gắn app_key, shop_cipher, sign và access_token.
  • API chỉ đọc; code = 0 mới là thành công.

Request

Endpoint

POST https://partner.quantri360.com/v1/tiktok/product/202309/products/listing_check

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_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.

Request parameters

NameInTypeRequiredSampleDescription
is_diagnosis_requiredqueryboolNofalseCó trả thông tin chất lượng và chẩn đoán hay không; trường đã ngừng khuyến nghị dùng.
descriptionbodystringYes<p>Sản phẩm minh họa.</p>Mô tả HTML tối đa 10.000 ký tự. Tối đa 30 thẻ img, mỗi ảnh dưới 4000 px, có src, width, height; ảnh phải được tải lên trước. Một số thẻ được chuyển đổi để hiển thị, như table thành ảnh. Nên mô tả trên 300 ký tự và 3–5 điểm nổi bật, mỗi điểm dưới 250 ký tự; ảnh khuyến nghị 1600×1600 px; độ dài tối đa: 10,000.
category_idbodystringYes900000000000000001Mã ngành hàng lá; giá trị liên quan: INVITE_ONLY, PRE_APPROVED, PENDING.
brand_idbodystringNo900000000000000001Mã thương hiệu.
main_imagesbodyobject[]Yes[{"uri": "anh-minh-hoa"}]Ảnh chính sản phẩm; dùng URI ảnh được tải lên trước; số phần tử tối đa: 9.
main_images[].uribodystringYesanh-minh-hoaURI ảnh đã tải lên; giá trị liên quan: MAIN_IMAGE.
skusbodyobject[]Yes[{"sales_attributes": [{"id": "900000000000000001", "name": "Minh họa", "value_id": "900000000000000001", "value_name": "Minh họa", "sku_img": {"uri": "anh-minh-hoa"}, "supplementary_sku_images": [{"uri": "anh-minh-hoa"}]}], "seller_sku": "SKU-MAU-01", "price": {"amount": "150000", "currency": "VND", "sale_price": "150000", "starting_bid_price": "Minh họa"}, "external_sku_id": "900000000000000001", "identifier_code": {"code": 0, "type": "GTIN"}, "inventory": [{"warehouse_id": "900000000000000001", "quantity": 1, "backorder_quantity": 1, "handling_time": 1793494800}], "combined_skus": [{"product_id": "900000000000000001", "sku_id": "900000000000000001", "sku_count": 1}], "sku_unit_count": "Minh họa", "external_urls": [""], "extra_identifier_codes": ["Minh họa"], "pre_sale": {"type": "PRE_ORDER", "fulfillment_type": {"handling_duration_days": 1, "release_date": 1}}, "list_price": {"amount": "150000", "currency": "VND"}, "external_list_prices": [{"source": "SHOPIFY_COMPARE_AT_PRICE", "amount": "150000", "currency": "VND"}], "fees": [{"type": "PFAND", "amount": "150000", "additional_attribute": "SINGLE_USE"}], "sku_dimensions": {"length": "Minh họa", "width": "Minh họa", "height": "Minh họa", "unit": "CENTIMETER"}, "sku_weight": {"value": "0.5", "unit": "KILOGRAM"}}]Các SKU biến thể; tối đa 300 tại BR, EU, MX, JP, UK, US, khu vực khác tối đa 100; nên đặt biến thể quan trọng nhất ở đầu.
skus[].sales_attributesbodyobject[]No[{"id": "900000000000000001", "name": "Minh họa", "value_id": "900000000000000001", "value_name": "Minh họa", "sku_img": {"uri": "anh-minh-hoa"}, "supplementary_sku_images": [{"uri": "anh-minh-hoa"}]}]Thuộc tính bán hàng tạo biến thể.
skus[].sales_attributes[].idbodystringNo900000000000000001Mã định danh.
skus[].sales_attributes[].namebodystringNoMinh họaTên; độ dài tối đa: 20.
skus[].sales_attributes[].value_idbodystringNo900000000000000001Mã giá trị.
skus[].sales_attributes[].value_namebodystringNoMinh họaTên giá trị; độ dài tối đa: 50.
skus[].sales_attributes[].sku_imgbodyobjectNo{"uri": "anh-minh-hoa"}Ảnh biến thể.
skus[].sales_attributes[].sku_img.uribodystringYesanh-minh-hoaURI ảnh đã tải lên; giá trị liên quan: ATTRIBUTE_IMAGE.
skus[].sales_attributes[].supplementary_sku_imagesbodyobject[]No[{"uri": "anh-minh-hoa"}]Ảnh SKU bổ sung.
skus[].sales_attributes[].supplementary_sku_images[].uribodystringYesanh-minh-hoaURI ảnh đã tải lên; giá trị liên quan: ATTRIBUTE_IMAGE.
skus[].seller_skubodystringNoSKU-MAU-01Mã SKU do người bán quản lý.
skus[].pricebodyobjectYes{"amount": "150000", "currency": "VND", "sale_price": "150000", "starting_bid_price": "Minh họa"}Giá.
skus[].price.amountbodystringNo150000Số tiền.
skus[].price.currencybodystringYesVNDMã tiền tệ; giá trị liên quan: BRL, CZK, EUR, GBP, HUF, IDR, JPY, MXN, MYR, PHP, PLN, SGD, THB, USD, VND.
skus[].price.sale_pricebodystringNo150000Giá hiển thị trước giảm giá.
skus[].price.starting_bid_pricebodystringNoMinh họaGiá bắt đầu đấu giá.
skus[].external_sku_idbodystringNo900000000000000001Mã SKU trong hệ thống bên ngoài; độ dài tối đa: 999.
skus[].identifier_codebodyobjectNo{"code": 0, "type": "GTIN"}Mã định danh bổ sung.
skus[].identifier_code.codebodystringNo0Mã kết quả; 0 là thành công; giá trị liên quan: X.
skus[].identifier_code.typebodystringNoGTINLoại; giá trị liên quan: GTIN, EAN, UPC, ISBN, JAN.
skus[].inventorybodyobject[]Yes[{"warehouse_id": "900000000000000001", "quantity": 1, "backorder_quantity": 1, "handling_time": 1793494800}]Tồn kho theo từng kho.
skus[].inventory[].warehouse_idbodystringYes900000000000000001Mã kho.
skus[].inventory[].quantitybodyintNo1Số lượng; giới hạn: [1, 99,999].
skus[].inventory[].backorder_quantitybodyintNo1Số lượng hàng đặt trước.
skus[].inventory[].handling_timebodyintNo1793494800Thời gian xử lý hàng đặt trước.
skus[].combined_skusbodyobject[]No[{"product_id": "900000000000000001", "sku_id": "900000000000000001", "sku_count": 1}]Các SKU kết hợp.
skus[].combined_skus[].product_idbodystringYes900000000000000001Mã sản phẩm.
skus[].combined_skus[].sku_idbodystringYes900000000000000001Mã SKU.
skus[].combined_skus[].sku_countbodyintYes1Số SKU.
skus[].sku_unit_countbodystringNoMinh họaSố đơn vị trong SKU; giới hạn: [0.01, 99,999.9999].
skus[].external_urlsbodystring[]No[""]Các địa chỉ bên ngoài.
skus[].extra_identifier_codesbodystring[]No["Minh họa"]Các mã định danh bổ sung; giá trị liên quan: X.
skus[].pre_salebodyobjectNo{"type": "PRE_ORDER", "fulfillment_type": {"handling_duration_days": 1, "release_date": 1}}Cấu hình bán trước.
skus[].pre_sale.typebodystringNoPRE_ORDERLoại; giá trị liên quan: PRE_ORDER, MADE_TO_ORDER, US, CUSTOM, UK, EU, SEA, JP, LATAM.
skus[].pre_sale.fulfillment_typebodyobjectNo{"handling_duration_days": 1, "release_date": 1}Hình thức hoàn tất đơn.
skus[].pre_sale.fulfillment_type.handling_duration_daysbodyintNo1Số ngày xử lý; giá trị liên quan: MADE_TO_ORDER, PRE_ORDER, CUSTOM.
skus[].pre_sale.fulfillment_type.release_datebodyintNo1Ngày phát hành; giá trị liên quan: PRE_ORDER.
skus[].list_pricebodyobjectNo{"amount": "150000", "currency": "VND"}Giá niêm yết.
skus[].list_price.amountbodystringYes150000Số tiền; giới hạn: [0.01, 7600].
skus[].list_price.currencybodystringYesVNDMã tiền tệ; giá trị liên quan: USD.
skus[].external_list_pricesbodyobject[]No[{"source": "SHOPIFY_COMPARE_AT_PRICE", "amount": "150000", "currency": "VND"}]Giá niêm yết bên ngoài.
skus[].external_list_prices[].sourcebodystringYesSHOPIFY_COMPARE_AT_PRICENguồn; giá trị liên quan: SHOPIFY_COMPARE_AT_PRICE.
skus[].external_list_prices[].amountbodystringYes150000Số tiền; giới hạn: [0.01, 7600].
skus[].external_list_prices[].currencybodystringYesVNDMã tiền tệ; giá trị liên quan: USD.
skus[].feesbodyobject[]No[{"type": "PFAND", "amount": "150000", "additional_attribute": "SINGLE_USE"}]Các khoản phí.
skus[].fees[].typebodystringNoPFANDLoại; giá trị liên quan: PFAND.
skus[].fees[].amountbodystringNo150000Số tiền.
skus[].fees[].additional_attributebodystringNoSINGLE_USEThuộc tính bổ sung; giá trị liên quan: SINGLE_USE, NOT_APPLICABLE, REUSABLE.
skus[].sku_dimensionsbodyobjectNo{"length": "Minh họa", "width": "Minh họa", "height": "Minh họa", "unit": "CENTIMETER"}Kích thước SKU.
skus[].sku_dimensions.lengthbodystringYesMinh họaChiều dài.
skus[].sku_dimensions.widthbodystringYesMinh họaChiều rộng.
skus[].sku_dimensions.heightbodystringYesMinh họaChiều cao.
skus[].sku_dimensions.unitbodystringYesCENTIMETERĐơn vị; giá trị liên quan: SKU, US, CENTIMETER, INCH, KILOGRAM.
skus[].sku_weightbodyobjectNo{"value": "0.5", "unit": "KILOGRAM"}Khối lượng SKU; giá trị liên quan: KILOGRAM, CENTIMETER.
skus[].sku_weight.valuebodystringYes0.5Giá trị.
skus[].sku_weight.unitbodystringYesKILOGRAMĐơn vị; giá trị liên quan: SKU, US, KILOGRAM, POUND, BR, JP, MX, GRAM, CENTIMETER.
titlebodystringYesÁo thun cotton cổ tròn minh họaTiêu đề sản phẩm; DE, ES, FR, IE, IT, JP, UK, US dài 1–255 ký tự; BR, MX dài 1–300; khu vực khác 25–255 ký tự.
is_cod_allowedbodyboolNofalseCho phép thanh toán khi nhận hàng.
certificationsbodyobject[]No[{"id": "900000000000000001", "images": [{"uri": "anh-minh-hoa"}], "files": [{"id": "900000000000000001", "name": "chungnhan.pdf", "format": "PDF"}], "expiration_date": 1793494800}]Chứng nhận sản phẩm; số phần tử tối đa: 10.
certifications[].idbodystringYes900000000000000001Mã định danh.
certifications[].imagesbodyobject[]No[{"uri": "anh-minh-hoa"}]Danh sách ảnh.
certifications[].images[].uribodystringYesanh-minh-hoaURI ảnh đã tải lên; giá trị liên quan: CERTIFICATION_IMAGE.
certifications[].filesbodyobject[]No[{"id": "900000000000000001", "name": "chungnhan.pdf", "format": "PDF"}]Danh sách tệp.
certifications[].files[].idbodystringYes900000000000000001Mã định danh.
certifications[].files[].namebodystringYeschungnhan.pdfTên.
certifications[].files[].formatbodystringYesPDFĐịnh dạng tệp.
certifications[].expiration_datebodyintNo1793494800Thời điểm hết hạn chứng nhận; Unix giây UTC+0.
package_weightbodyobjectNo{"value": "0.5", "unit": "KILOGRAM"}Khối lượng sau đóng gói; mặc định bắt buộc, trừ ngành hàng sản phẩm ảo. Phải khai chính xác vì ảnh hưởng phí giao hàng.
package_weight.valuebodystringYes0.5Giá trị; giá trị liên quan: GRAM, KILOGRAM, POUND.
package_weight.unitbodystringYesKILOGRAMĐơn vị; giá trị liên quan: US, KILOGRAM, POUND, BR, JP, MX, GRAM, CENTIMETER.
product_attributesbodyobject[]No[{"id": "900000000000000001", "values": [{"id": "900000000000000001", "name": "Minh họa"}]}]Thuộc tính sản phẩm; điền đủ thuộc tính bắt buộc của ngành hàng.
product_attributes[].idbodystringYes900000000000000001Mã định danh.
product_attributes[].valuesbodyobject[]Yes[{"id": "900000000000000001", "name": "Minh họa"}]Các giá trị.
product_attributes[].values[].idbodystringNo900000000000000001Mã định danh.
product_attributes[].values[].namebodystringNoMinh họaTên; độ dài tối đa: 2000.
size_chartbodyobjectNo{"image": {"uri": "anh-minh-hoa"}, "template": {"id": "900000000000000001"}}Bảng kích cỡ sản phẩm; có thể bắt buộc hoặc không được hỗ trợ tùy ngành hàng. Nếu ngành không hỗ trợ thì nội dung gửi sẽ bị bỏ qua.
size_chart.imagebodyobjectNo{"uri": "anh-minh-hoa"}Ảnh.
size_chart.image.uribodystringYesanh-minh-hoaURI ảnh đã tải lên; giá trị liên quan: SIZE_CHART_IMAGE.
size_chart.templatebodyobjectNo{"id": "900000000000000001"}Mẫu.
size_chart.template.idbodystringYes900000000000000001Mã định danh.
package_dimensionsbodyobjectNo{"length": "Minh họa", "width": "Minh họa", "height": "Minh họa", "unit": "CENTIMETER"}Kích thước sau đóng gói, ảnh hưởng phí giao hàng; không bắt buộc tại ID, TH, VN.
package_dimensions.lengthbodystringYesMinh họaChiều dài.
package_dimensions.widthbodystringYesMinh họaChiều rộng.
package_dimensions.heightbodystringYesMinh họaChiều cao.
package_dimensions.unitbodystringYesCENTIMETERĐơn vị; giá trị liên quan: US, CENTIMETER, INCH, KILOGRAM.
external_product_idbodystringNo900000000000000001Mã sản phẩm trong hệ thống bên ngoài; độ dài tối đa: 999.
delivery_option_idsbodystring[]No["900000000000000001"]Danh sách mã phương thức giao hàng.
videobodyobjectNo{"id": "900000000000000001"}Video giới thiệu sản phẩm; khuyến nghị tỷ lệ 1:1, độ phân giải HD 720p trở lên, dài 20–60 giây.
video.idbodystringYes900000000000000001Mã định danh.
primary_combined_product_idbodystringNo900000000000000001Mã sản phẩm chính của bộ sản phẩm ảo; chỉ bắt buộc cho sản phẩm bộ ảo.
manufacturer_idsbodystring[]No["900000000000000001"]Danh sách mã nhà sản xuất.
responsible_person_idsbodystring[]No["900000000000000001"]Danh sách mã người chịu trách nhiệm.
listing_platformsbodystring[]No["TIKTOK_SHOP"]Danh sách nền tảng đăng sản phẩm; giá trị liên quan: TIKTOK_SHOP, TOKOPEDIA.
shipping_insurance_requirementbodystringNoNOT_SUPPORTEDYêu cầu bảo hiểm vận chuyển; giá trị liên quan: NOT_SUPPORTED, REQUIRED, OPTIONAL, TOKOPEDIA.
is_pre_ownedbodyboolNofalseSản phẩm đã qua sử dụng.
minimum_order_quantitybodyintNo1Số lượng mua tối thiểu; giới hạn: [1, 20].
shipping_template_idbodystringNo900000000000000001Mã mẫu vận chuyển.
optionbodyobjectNo{"need_trigger_gne_async_check": false, "gne_async_check_session_id": "900000000000000001"}Tùy chọn.
option.need_trigger_gne_async_checkbodyboolNofalseBật kiểm tra bất đồng bộ.
option.gne_async_check_session_idbodystringNo900000000000000001Mã phiên kiểm tra bất đồng bộ.
scheduled_salebodyobjectNo{"is_enabled_scheduled_sale": false, "schedule_sale_time": 1793494800}Cấu hình bán theo lịch.
scheduled_sale.is_enabled_scheduled_salebodyboolYesfalseBật bán theo lịch.
scheduled_sale.schedule_sale_timebodyintYes1793494800Thời điểm bắt đầu bán theo lịch.
search_termsbodystring[]No["Minh họa"]Từ khóa tìm kiếm không hiển thị với khách; phải phù hợp mô tả, tối đa 15 từ khóa và tổng 250 ký tự.
key_product_featuresbodystring[]No["Minh họa"]Điểm nổi bật hiển thị trên trang sản phẩm và dùng cho tìm kiếm; tối đa 5 mục, tổng 1500 ký tự.
product_tag_operationsbodyobject[]No[{"product_tag": "AUCTION", "enable": false}]Thao tác cũ để bật/tắt nhãn AUCTION; nếu có selling_format thì ưu tiên selling_format; giá trị liên quan: AUCTION.
product_tag_operations[].product_tagbodystringYesAUCTIONNhãn sản phẩm; giá trị liên quan: AUCTION.
product_tag_operations[].enablebodyboolYesfalseBật hoặc tắt; giá trị liên quan: AUCTION.
localebodystringNovi-VNMã ngôn ngữ hiển thị; mặc định theo gian hàng; giá trị liên quan: BCP, CZ, AT, BE, DE, GR, GB, IE, US, ES, MX, FR, HU, IT, JP, MY, NL, PL, BR, PT, TH, VN, CN.
selling_formatbodystringNoFIXED_PRICE_AND_LIVE_AUCTIONFIXED_PRICE bán giá cố định, mặc định; FIXED_PRICE_AND_LIVE_AUCTION kết hợp đấu giá LIVE và cần starting_bid_price; giá trị liên quan: FIXED_PRICE, FIXED_PRICE_AND_LIVE_AUCTION, LIVE.
is_live_quickbodyboolNofalseSản phẩm LIVE_QUICK; chỉ người bán có quyền tương ứng mới được tạo; giá trị liên quan: LIVE_QUICK.

Request examples

curl -s -X POST "https://partner.quantri360.com/v1/tiktok/product/202309/products/listing_check?is_diagnosis_required=false" \
  -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/json" \
  -d '{"description":"<p>Sản phẩm minh họa.</p>","category_id":"900000000000000001","brand_id":"900000000000000001","main_images":[{"uri":"anh-minh-hoa"}],"skus":[{"sales_attributes":[{"id":"900000000000000001","name":"Minh họa","value_id":"900000000000000001","value_name":"Minh họa","sku_img":{"uri":"anh-minh-hoa"},"supplementary_sku_images":[{"uri":"anh-minh-hoa"}]}],"seller_sku":"SKU-MAU-01","price":{"amount":"150000","currency":"VND","sale_price":"150000","starting_bid_price":"Minh họa"},"external_sku_id":"900000000000000001","identifier_code":{"code":0,"type":"GTIN"},"inventory":[{"warehouse_id":"900000000000000001","quantity":1,"backorder_quantity":1,"handling_time":1793494800}],"combined_skus":[{"product_id":"900000000000000001","sku_id":"900000000000000001","sku_count":1}],"sku_unit_count":"Minh họa","external_urls":[""],"extra_identifier_codes":["Minh họa"],"pre_sale":{"type":"PRE_ORDER","fulfillment_type":{"handling_duration_days":1,"release_date":1}},"list_price":{"amount":"150000","currency":"VND"},"external_list_prices":[{"source":"SHOPIFY_COMPARE_AT_PRICE","amount":"150000","currency":"VND"}],"fees":[{"type":"PFAND","amount":"150000","additional_attribute":"SINGLE_USE"}],"sku_dimensions":{"length":"Minh họa","width":"Minh họa","height":"Minh họa","unit":"CENTIMETER"},"sku_weight":{"value":"0.5","unit":"KILOGRAM"}}],"title":"Áo thun cotton cổ tròn minh họa","is_cod_allowed":false,"certifications":[{"id":"900000000000000001","images":[{"uri":"anh-minh-hoa"}],"files":[{"id":"900000000000000001","name":"chungnhan.pdf","format":"PDF"}],"expiration_date":1793494800}],"package_weight":{"value":"0.5","unit":"KILOGRAM"},"product_attributes":[{"id":"900000000000000001","values":[{"id":"900000000000000001","name":"Minh họa"}]}],"size_chart":{"image":{"uri":"anh-minh-hoa"},"template":{"id":"900000000000000001"}},"package_dimensions":{"length":"Minh họa","width":"Minh họa","height":"Minh họa","unit":"CENTIMETER"},"external_product_id":"900000000000000001","delivery_option_ids":["900000000000000001"],"video":{"id":"900000000000000001"},"primary_combined_product_id":"900000000000000001","manufacturer_ids":["900000000000000001"],"responsible_person_ids":["900000000000000001"],"listing_platforms":["TIKTOK_SHOP"],"shipping_insurance_requirement":"NOT_SUPPORTED","is_pre_owned":false,"minimum_order_quantity":1,"shipping_template_id":"900000000000000001","option":{"need_trigger_gne_async_check":false,"gne_async_check_session_id":"900000000000000001"},"scheduled_sale":{"is_enabled_scheduled_sale":false,"schedule_sale_time":1793494800},"search_terms":["Minh họa"],"key_product_features":["Minh họa"],"product_tag_operations":[{"product_tag":"AUCTION","enable":false}],"locale":"vi-VN","selling_format":"FIXED_PRICE_AND_LIVE_AUCTION","is_live_quick":false}'
Python
import requests

KEY = "q360_live_..."  # khóa API của brand
r = requests.post(
    "https://partner.quantri360.com/v1/tiktok/product/202309/products/listing_check",
    params={
        "is_diagnosis_required": False
    },
    json={
        "description": "<p>Sản phẩm minh họa.</p>",
        "category_id": "900000000000000001",
        "brand_id": "900000000000000001",
        "main_images": [
            {
                "uri": "anh-minh-hoa"
            }
        ],
        "skus": [
            {
                "sales_attributes": [
                    {
                        "id": "900000000000000001",
                        "name": "Minh họa",
                        "value_id": "900000000000000001",
                        "value_name": "Minh họa",
                        "sku_img": {
                            "uri": "anh-minh-hoa"
                        },
                        "supplementary_sku_images": [
                            {
                                "uri": "anh-minh-hoa"
                            }
                        ]
                    }
                ],
                "seller_sku": "SKU-MAU-01",
                "price": {
                    "amount": "150000",
                    "currency": "VND",
                    "sale_price": "150000",
                    "starting_bid_price": "Minh họa"
                },
                "external_sku_id": "900000000000000001",
                "identifier_code": {
                    "code": 0,
                    "type": "GTIN"
                },
                "inventory": [
                    {
                        "warehouse_id": "900000000000000001",
                        "quantity": 1,
                        "backorder_quantity": 1,
                        "handling_time": 1793494800
                    }
                ],
                "combined_skus": [
                    {
                        "product_id": "900000000000000001",
                        "sku_id": "900000000000000001",
                        "sku_count": 1
                    }
                ],
                "sku_unit_count": "Minh họa",
                "external_urls": [
                    ""
                ],
                "extra_identifier_codes": [
                    "Minh họa"
                ],
                "pre_sale": {
                    "type": "PRE_ORDER",
                    "fulfillment_type": {
                        "handling_duration_days": 1,
                        "release_date": 1
                    }
                },
                "list_price": {
                    "amount": "150000",
                    "currency": "VND"
                },
                "external_list_prices": [
                    {
                        "source": "SHOPIFY_COMPARE_AT_PRICE",
                        "amount": "150000",
                        "currency": "VND"
                    }
                ],
                "fees": [
                    {
                        "type": "PFAND",
                        "amount": "150000",
                        "additional_attribute": "SINGLE_USE"
                    }
                ],
                "sku_dimensions": {
                    "length": "Minh họa",
                    "width": "Minh họa",
                    "height": "Minh họa",
                    "unit": "CENTIMETER"
                },
                "sku_weight": {
                    "value": "0.5",
                    "unit": "KILOGRAM"
                }
            }
        ],
        "title": "Áo thun cotton cổ tròn minh họa",
        "is_cod_allowed": False,
        "certifications": [
            {
                "id": "900000000000000001",
                "images": [
                    {
                        "uri": "anh-minh-hoa"
                    }
                ],
                "files": [
                    {
                        "id": "900000000000000001",
                        "name": "chungnhan.pdf",
                        "format": "PDF"
                    }
                ],
                "expiration_date": 1793494800
            }
        ],
        "package_weight": {
            "value": "0.5",
            "unit": "KILOGRAM"
        },
        "product_attributes": [
            {
                "id": "900000000000000001",
                "values": [
                    {
                        "id": "900000000000000001",
                        "name": "Minh họa"
                    }
                ]
            }
        ],
        "size_chart": {
            "image": {
                "uri": "anh-minh-hoa"
            },
            "template": {
                "id": "900000000000000001"
            }
        },
        "package_dimensions": {
            "length": "Minh họa",
            "width": "Minh họa",
            "height": "Minh họa",
            "unit": "CENTIMETER"
        },
        "external_product_id": "900000000000000001",
        "delivery_option_ids": [
            "900000000000000001"
        ],
        "video": {
            "id": "900000000000000001"
        },
        "primary_combined_product_id": "900000000000000001",
        "manufacturer_ids": [
            "900000000000000001"
        ],
        "responsible_person_ids": [
            "900000000000000001"
        ],
        "listing_platforms": [
            "TIKTOK_SHOP"
        ],
        "shipping_insurance_requirement": "NOT_SUPPORTED",
        "is_pre_owned": False,
        "minimum_order_quantity": 1,
        "shipping_template_id": "900000000000000001",
        "option": {
            "need_trigger_gne_async_check": False,
            "gne_async_check_session_id": "900000000000000001"
        },
        "scheduled_sale": {
            "is_enabled_scheduled_sale": False,
            "schedule_sale_time": 1793494800
        },
        "search_terms": [
            "Minh họa"
        ],
        "key_product_features": [
            "Minh họa"
        ],
        "product_tag_operations": [
            {
                "product_tag": "AUCTION",
                "enable": False
            }
        ],
        "locale": "vi-VN",
        "selling_format": "FIXED_PRICE_AND_LIVE_AUCTION",
        "is_live_quick": False
    },
    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/listing_check');
for (const [k, v] of Object.entries({"is_diagnosis_required":false})) 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({"description":"<p>Sản phẩm minh họa.</p>","category_id":"900000000000000001","brand_id":"900000000000000001","main_images":[{"uri":"anh-minh-hoa"}],"skus":[{"sales_attributes":[{"id":"900000000000000001","name":"Minh họa","value_id":"900000000000000001","value_name":"Minh họa","sku_img":{"uri":"anh-minh-hoa"},"supplementary_sku_images":[{"uri":"anh-minh-hoa"}]}],"seller_sku":"SKU-MAU-01","price":{"amount":"150000","currency":"VND","sale_price":"150000","starting_bid_price":"Minh họa"},"external_sku_id":"900000000000000001","identifier_code":{"code":0,"type":"GTIN"},"inventory":[{"warehouse_id":"900000000000000001","quantity":1,"backorder_quantity":1,"handling_time":1793494800}],"combined_skus":[{"product_id":"900000000000000001","sku_id":"900000000000000001","sku_count":1}],"sku_unit_count":"Minh họa","external_urls":[""],"extra_identifier_codes":["Minh họa"],"pre_sale":{"type":"PRE_ORDER","fulfillment_type":{"handling_duration_days":1,"release_date":1}},"list_price":{"amount":"150000","currency":"VND"},"external_list_prices":[{"source":"SHOPIFY_COMPARE_AT_PRICE","amount":"150000","currency":"VND"}],"fees":[{"type":"PFAND","amount":"150000","additional_attribute":"SINGLE_USE"}],"sku_dimensions":{"length":"Minh họa","width":"Minh họa","height":"Minh họa","unit":"CENTIMETER"},"sku_weight":{"value":"0.5","unit":"KILOGRAM"}}],"title":"Áo thun cotton cổ tròn minh họa","is_cod_allowed":false,"certifications":[{"id":"900000000000000001","images":[{"uri":"anh-minh-hoa"}],"files":[{"id":"900000000000000001","name":"chungnhan.pdf","format":"PDF"}],"expiration_date":1793494800}],"package_weight":{"value":"0.5","unit":"KILOGRAM"},"product_attributes":[{"id":"900000000000000001","values":[{"id":"900000000000000001","name":"Minh họa"}]}],"size_chart":{"image":{"uri":"anh-minh-hoa"},"template":{"id":"900000000000000001"}},"package_dimensions":{"length":"Minh họa","width":"Minh họa","height":"Minh họa","unit":"CENTIMETER"},"external_product_id":"900000000000000001","delivery_option_ids":["900000000000000001"],"video":{"id":"900000000000000001"},"primary_combined_product_id":"900000000000000001","manufacturer_ids":["900000000000000001"],"responsible_person_ids":["900000000000000001"],"listing_platforms":["TIKTOK_SHOP"],"shipping_insurance_requirement":"NOT_SUPPORTED","is_pre_owned":false,"minimum_order_quantity":1,"shipping_template_id":"900000000000000001","option":{"need_trigger_gne_async_check":false,"gne_async_check_session_id":"900000000000000001"},"scheduled_sale":{"is_enabled_scheduled_sale":false,"schedule_sale_time":1793494800},"search_terms":["Minh họa"],"key_product_features":["Minh họa"],"product_tag_operations":[{"product_tag":"AUCTION","enable":false}],"locale":"vi-VN","selling_format":"FIXED_PRICE_AND_LIVE_AUCTION","is_live_quick":false}),
});
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/listing_check' . '?' . http_build_query(['is_diagnosis_required' => 'false']);
$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, '{"description":"<p>Sản phẩm minh họa.</p>","category_id":"900000000000000001","brand_id":"900000000000000001","main_images":[{"uri":"anh-minh-hoa"}],"skus":[{"sales_attributes":[{"id":"900000000000000001","name":"Minh họa","value_id":"900000000000000001","value_name":"Minh họa","sku_img":{"uri":"anh-minh-hoa"},"supplementary_sku_images":[{"uri":"anh-minh-hoa"}]}],"seller_sku":"SKU-MAU-01","price":{"amount":"150000","currency":"VND","sale_price":"150000","starting_bid_price":"Minh họa"},"external_sku_id":"900000000000000001","identifier_code":{"code":0,"type":"GTIN"},"inventory":[{"warehouse_id":"900000000000000001","quantity":1,"backorder_quantity":1,"handling_time":1793494800}],"combined_skus":[{"product_id":"900000000000000001","sku_id":"900000000000000001","sku_count":1}],"sku_unit_count":"Minh họa","external_urls":[""],"extra_identifier_codes":["Minh họa"],"pre_sale":{"type":"PRE_ORDER","fulfillment_type":{"handling_duration_days":1,"release_date":1}},"list_price":{"amount":"150000","currency":"VND"},"external_list_prices":[{"source":"SHOPIFY_COMPARE_AT_PRICE","amount":"150000","currency":"VND"}],"fees":[{"type":"PFAND","amount":"150000","additional_attribute":"SINGLE_USE"}],"sku_dimensions":{"length":"Minh họa","width":"Minh họa","height":"Minh họa","unit":"CENTIMETER"},"sku_weight":{"value":"0.5","unit":"KILOGRAM"}}],"title":"Áo thun cotton cổ tròn minh họa","is_cod_allowed":false,"certifications":[{"id":"900000000000000001","images":[{"uri":"anh-minh-hoa"}],"files":[{"id":"900000000000000001","name":"chungnhan.pdf","format":"PDF"}],"expiration_date":1793494800}],"package_weight":{"value":"0.5","unit":"KILOGRAM"},"product_attributes":[{"id":"900000000000000001","values":[{"id":"900000000000000001","name":"Minh họa"}]}],"size_chart":{"image":{"uri":"anh-minh-hoa"},"template":{"id":"900000000000000001"}},"package_dimensions":{"length":"Minh họa","width":"Minh họa","height":"Minh họa","unit":"CENTIMETER"},"external_product_id":"900000000000000001","delivery_option_ids":["900000000000000001"],"video":{"id":"900000000000000001"},"primary_combined_product_id":"900000000000000001","manufacturer_ids":["900000000000000001"],"responsible_person_ids":["900000000000000001"],"listing_platforms":["TIKTOK_SHOP"],"shipping_insurance_requirement":"NOT_SUPPORTED","is_pre_owned":false,"minimum_order_quantity":1,"shipping_template_id":"900000000000000001","option":{"need_trigger_gne_async_check":false,"gne_async_check_session_id":"900000000000000001"},"scheduled_sale":{"is_enabled_scheduled_sale":false,"schedule_sale_time":1793494800},"search_terms":["Minh họa"],"key_product_features":["Minh họa"],"product_tag_operations":[{"product_tag":"AUCTION","enable":false}],"locale":"vi-VN","selling_format":"FIXED_PRICE_AND_LIVE_AUCTION","is_live_quick":false}');
$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)

NameTypeSampleDescription
codeint0Mã kết quả; 0 là thành công.
messagestringSuccessThông báo kết quả.
request_idstringYEU_CAU_MINH_HOAMã yêu cầu để tra cứu lỗi.
dataobjectDữ liệu.
check_resultstringFAILEDKết quả kiểm tra.
fail_reasonsobject[]Các lý do không đạt.
codeint0Mã kết quả; 0 là thành công.
messagestringSuccessThông báo kết quả.
warningsobjectCảnh báo.
messagestringSuccessThông báo kết quả; giá trị liên quan: FAILED.
listing_qualityobjectChất lượng đăng bán.
current_tierstringPOORMức hiện tại; giá trị liên quan: POOR, FAIR, GOOD, EXCELLENT, US.
remaining_recommendationsint1Các đề xuất còn lại.
diagnosesobject[]Kết quả chẩn đoán.
fieldstringTITLETrường cần xử lý; giá trị liên quan: SIZE_CHART, TITLE, DESCRIPTION, IMAGE, ATTRIBUTE.
diagnosis_resultsobject[]Các kết quả chẩn đoán.
codestring0Mã kết quả; 0 là thành công.
how_to_solvestringMinh họaCách khắc phục.
quality_tierstringFAIRMức chất lượng; giá trị liên quan: FAIR, GOOD, US.
suggestionsobjectCác gợi ý.
seo_wordsobject[]Từ khóa SEO.
textstringMinh họaNội dung văn bản.
smart_textsobject[]Nội dung văn bản được tối ưu.
textstringMinh họaNội dung văn bản.
imagesobject[]Danh sách ảnh.
uristringanh-minh-hoaURI ảnh đã tải lên.
urlstringĐịa chỉ hiển thị.
optimized_uristringanh-minh-hoaURI ảnh đã tối ưu.
optimized_urlstringĐịa chỉ ảnh đã tối ưu.
heightint800Chiều cao.
widthint800Chiều rộng.
pre_check_resultsobject[]Kết quả kiểm tra sơ bộ.
pre_check_itemstringMinh họaMục kiểm tra sơ bộ.
pre_check_detailsobject[]Chi tiết kiểm tra sơ bộ.
short_reasonstringMinh họaLý do ngắn.
long_reasonstringMinh họaLý do đầy đủ.
related_fieldsstring[]Các trường liên quan; giá trị liên quan: PRE_CHECK_FIELD_TITLE, PRE_CHECK_FIELD_IMAGES.

Response sample

{
  "code": 0,
  "message": "Success",
  "request_id": "YEU_CAU_MINH_HOA",
  "data": {
    "check_result": "FAILED",
    "fail_reasons": [
      {
        "code": 0,
        "message": "Success"
      }
    ],
    "warnings": {
      "message": "Success"
    },
    "listing_quality": {
      "current_tier": "POOR",
      "remaining_recommendations": 1
    },
    "diagnoses": [
      {
        "field": "TITLE",
        "diagnosis_results": [
          {
            "code": 0,
            "how_to_solve": "Minh họa",
            "quality_tier": "FAIR"
          }
        ],
        "suggestions": {
          "seo_words": [
            {
              "text": "Minh họa"
            }
          ],
          "smart_texts": [
            {
              "text": "Minh họa"
            }
          ],
          "images": [
            {
              "uri": "anh-minh-hoa",
              "url": "",
              "optimized_uri": "anh-minh-hoa",
              "optimized_url": "",
              "height": 800,
              "width": 800
            }
          ]
        }
      }
    ],
    "pre_check_results": [
      {
        "pre_check_item": "Minh họa",
        "pre_check_details": [
          {
            "short_reason": "Minh họa",
            "long_reason": "Minh họa",
            "related_fields": [
              "PRE_CHECK_FIELD_TITLE"
            ]
          }
        ]
      }
    ]
  }
}

Get started

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