Developer resources

Post Shoppable Photos — TikTok Shop API

tiktok.affiliate_creator.202610.photos · 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.

Open in the API index TikTok Shop platform page

tiktok.affiliate_creator.202610.photos

POST/affiliate_creator/202610/photosVia 360: POST https://partner.quantri360.com/v1/tiktok/affiliate_creator/202610/photos

Write endpoint — changes data on TikTok Shop. The key must be created with "Allow write API calls" ticked, otherwise you get 403 write_not_allowed. Every call is logged.

Description

DÀNH CHO CREATOR: Đăng nội dung ảnh có gắn sản phẩm hoặc gian hàng bằng URI ảnh đã tải lên và thông tin đi kèm.

HIỆN CHƯA GỌI ĐƯỢC QUA 360: API này dùng kết nối của creator / đối tác, kết nối gian hàng trả code 36009005. Cần dùng → liên hệ 360.
API GHI: thay đổi dữ liệu thật trên TikTok Shop; cần key có quyền ghi (can_write) và gói mở module affiliate. Đăng nội dung ảnh có gắn sản phẩm hoặc gian hàng bằng URI ảnh đã tải lên và thông tin đi kèm.
HTTP 200 vẫn có thể có lỗi nghiệp vụ; kiểm code trước khi dùng kết quả.

Request

Endpoint

POST https://partner.quantri360.com/v1/tiktok/affiliate_creator/202610/photos

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
photos_info	body	[]object	Yes		Danh sách ảnh và thông tin đi kèm.
photos_info[].photo_file_uris	body	string	Yes	DEMO_PHOTO_URI	URI ảnh từ kết quả tải ảnh; không gửi tệp vào trường này.
music_id	body	string	No	100000000000000201	Music mã.
title	body	string	No	Sản phẩm minh họa	Chú thích bài ảnh, tối đa 5000 đơn vị UTF-16; bỏ qua thì không có chú thích. Có thể thêm hashtag theo dạng #chude.
link_info	body	object	No		Liên kết thông tin.
link_info.post_type	body	string	Yes	1	Loại liên kết: 1-LINK_TO_PRODUCT, 2-LINK_TO_SHOP, 3-LINK_TO_ONE_PIC_ONE_PRODUCT.
link_info.shop_info	body	object	No		Gian hàng thông tin.
link_info.shop_info.shop_id	body	string	No	100000000000000101	Mã gian hàng.
link_info.shop_info.group_type	body	string	No	1	1 trang chủ gian hàng; 2 ngành hàng; 3 bộ sưu tập.
link_info.shop_info.group_id	body	string	No	100000000000000401	Mã ngành hàng hoặc bộ sưu tập tương ứng group_type.
link_info.links	body	[]object	No		Liên kết.
link_info.links[].product_id	body	string	No	100000000000000101	Mã sản phẩm.
link_info.links[].link_title	body	string	No	Minh họa	Tiêu đề liên kết trên ảnh, ngắn hơn 30 ký tự.
is_ai_generated	body	bool	No	false	true hiển thị nhãn nội dung do AI tạo.

Request examples

curl -s -X POST "https://partner.quantri360.com/v1/tiktok/affiliate_creator/202610/photos" \
  -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/json" \
  -d '{"photos_info":[{"photo_file_uris":"DEMO_PHOTO_URI"}],"link_info":{"post_type":"1","shop_info":{"shop_id":"100000000000000101","group_type":"1","group_id":"100000000000000401"},"links":[{"product_id":"100000000000000101","link_title":"Minh họa"}]}}'

Python

import requests

KEY = "q360_live_..."  # khóa API của brand
r = requests.post(
    "https://partner.quantri360.com/v1/tiktok/affiliate_creator/202610/photos",
    params={},
    json={
        "photos_info": [
            {
                "photo_file_uris": "DEMO_PHOTO_URI"
            }
        ],
        "link_info": {
            "post_type": "1",
            "shop_info": {
                "shop_id": "100000000000000101",
                "group_type": "1",
                "group_id": "100000000000000401"
            },
            "links": [
                {
                    "product_id": "100000000000000101",
                    "link_title": "Minh họa"
                }
            ]
        }
    },
    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/affiliate_creator/202610/photos');
for (const [k, v] of Object.entries({})) 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({"photos_info":[{"photo_file_uris":"DEMO_PHOTO_URI"}],"link_info":{"post_type":"1","shop_info":{"shop_id":"100000000000000101","group_type":"1","group_id":"100000000000000401"},"links":[{"product_id":"100000000000000101","link_title":"Minh họa"}]}}),
});
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/affiliate_creator/202610/photos' . '?' . http_build_query([]);
$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, '{"photos_info":[{"photo_file_uris":"DEMO_PHOTO_URI"}],"link_info":{"post_type":"1","shop_info":{"shop_id":"100000000000000101","group_type":"1","group_id":"100000000000000401"},"links":[{"product_id":"100000000000000101","link_title":"Minh họa"}]}}');
$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	Mã kết quả; 0 là thành công.
message	string	Success	Thông báo kết quả.
request_id	string	DEMO_AFFILIATE_REQUEST	Mã truy vết yêu cầu.
data	object		Dữ liệu phản hồi.
photo	object		Ảnh.
photo_post_id	string	100000000000000101	Ảnh bài đăng mã.
quota	string	Minh họa	Hạn mức.

Response sample

{
  "code": 0,
  "message": "Success",
  "request_id": "DEMO_AFFILIATE_REQUEST",
  "data": {
    "photo": {
      "photo_post_id": "100000000000000101"
    },
    "quota": "Minh họa"
  }
}

Get started

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