Developer resources

Create a creative pre-review task — TikTok Business API

Create a creative pre-review task · 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 Business platform page

Create a creative pre-review task

POST/creative/pre_review/task/create/Via 360: POST https://partner.quantri360.com/v1/tiktok_business/creative/pre_review/task/create/

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

Description

Use this endpoint to create a pre-review task for your creatives.

A pre-review task is a process initiated to evaluate and assess the compliance and quality of your creatives before they are used to create ads, ensuring that they meet TikTok advertising guidelines and standards.

After you create the task, call /creative/pre_review/task/get/ to check the task result. The time required to process each task may vary based on the number of creatives. The average processing time of each pre-review tas

Request

Endpoint

POST https://partner.quantri360.com/v1/tiktok_business/creative/pre_review/task/create/

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	7000000000000000001	Tài sản TikTok Business đã kết nối — "Mã tài sản" ở trang Nền tảng hoặc GET /v1/platforms (tài khoản quảng cáo cho Marketing API, tài khoản TikTok cho Organic / Messaging). Có thể bỏ khi chỉ kết nối một tài sản.

Request parameters

Name	In	Type	Required	Description
material_list	body	object[]	Yes	The list of creatives to submit for pre-review. Size range: 1-5.
location_codes	body	string[]	Yes	The codes of the locations that you want to target. Max size: 1. For enum values, see List of values for `location_codes` or `location_code`. Example: `US`.
is_ecommerce	body	boolean	No	Whether the creatives are intended for use in E-commerce ads, including GMV Max Campaigns and Catalog Ads. Supported values: `true`, `false`. Default value: `false`.

Request examples

curl -s -X POST "https://partner.quantri360.com/v1/tiktok_business/creative/pre_review/task/create/" \
  -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/json" \
  -d '{"material_list":[{"material_type":"","material_id":""}],"location_codes":[]}'

Python

import requests

KEY = "q360_live_..."  # khóa API của brand
r = requests.post(
    "https://partner.quantri360.com/v1/tiktok_business/creative/pre_review/task/create/",
    params={},
    json={
        "material_list": [
            {
                "material_type": "",
                "material_id": ""
            }
        ],
        "location_codes": []
    },
    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_business/creative/pre_review/task/create/');
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({"material_list":[{"material_type":"","material_id":""}],"location_codes":[]}),
});
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_business/creative/pre_review/task/create/' . '?' . 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, '{"material_list":[{"material_type":"","material_id":""}],"location_codes":[]}');
$res = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
echo $status, "\n", $res;