Remove products
POST/catalog/product/delete/Via 360: POST https://partner.quantri360.com/v1/tiktok_business/catalog/product/delete/
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 delete products in bulk.
In the response, you will get a task processing ID feed_log_id. With this ID you can view the processing status and final results of the task via the /catalog/product/log/ endpoint.
> Note
>
- The SKU is unique under the same Catalog, and the re-upload operation for a SKU can only be carried out under the feed that belongs to this SKU.
- For each catalog, you can make up to 1,000 requests per hour. If this does not meet your needs, please contact your TikTok representative.
- For each catalog, you can only send one request at a time. The limit applies to both uploading and deleting. If you send two requests at the same time, the latter will fail. You are recommended to send one request first, and send the next after the previous request is completed.
Request
Endpoint
POST https://partner.quantri360.com/v1/tiktok_business/catalog/product/delete/
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 | Sample | Description |
|---|---|---|---|---|---|
| bc_id | body | string | Yes | Business Center ID. To obtain the list of Business Centers that you can access, use /bc/get/. | |
| catalog_id | body | string | Yes | Catalog ID.
To obtain the list of catalogs that you can access, use /bc/asset/get/ and set asset_type to CATALOG. | |
| sku_ids | body | string[] | No | Required for products in an E-commerce catalog.
SKU IDs of E-commerce products that you want to delete.
Max size: 1,000.
Length limit: 100 characters for each SKU ID and cannot contain emojis.
To obtain SKU IDs for products in an E-commerce catalog, use /catalog/product/get/. The SKU IDs will be available from the response parameter sku_id.
Note: Duplicate SKU IDs are not supported. | |
| hotel_ids | body | string[] | No | Required for products in a hotel catalog.
Hotel IDs of products that you want to delete.
Max size: 1,000.
Length limit: 100 characters for each hotel ID.
To obtain hotel IDs for products in a hotel catalog, use /catalog/product/get/. The hotel IDs will be available from the response parameter hotel_id.
Note: Duplicate hotel IDs are not supported. | |
| flight_ids | body | string[] | No | Required for products in a flight catalog.
Flight IDs of products that you want to delete.
Max size: 1,000.
Length limit: 150 characters for each flight ID.
To obtain flight IDs for products in a flight catalog, use /catalog/product/get/. The flight IDs will be available from the response parameter flight_id.
Note: Duplicate flight IDs are not supported. | |
| destination_ids | body | string[] | No | Required for products in a destination catalog.
Destination IDs of products that you want to delete.
Max size: 1,000.
Length limit: 100 characters for each destination ID.
To obtain destination IDs for products in a destination catalog, use /catalog/product/get/. The destination IDs will be available from the response parameter destination_id.
Note: Duplicate destination IDs are not supported. | |
| vehicle_ids | body | string[] | No | Required for products in an Auto-Inventory or Auto-Model catalog.
IDs of vehicles that you want to delete.
Max size: 1,000.
Length limit: 100 characters for each vehicle ID and cannot contain emojis.
To obtain vehicle IDs for products in an Auto-Inventory or Auto-Model catalog, use /catalog/product/get/. The vehicle IDs will be available from the response parameter vehicle_id.
Note: Duplicate vehicle IDs are not supported. | |
| series_ids | body | string[] | No | Required for products in a mini series catalog.
IDs of the short drama series that you want to delete.
Max size: 1,000.
Length limit: 100 characters for each short drama series ID.
To obtain short drama series IDs for products in a mini series catalog, use /catalog/product/get/. The short drama series IDs will be available from the response parameter series_id.
Note: Duplicate short drama series IDs are not supported. | |
| item_ids | body | string[] | No | Required for products or services in a generic catalog.
IDs of products or services that you want to delete.
Max size: 10,000.
To obtain IDs for products or services in a generic catalog, use /catalog/product/get/. The IDs will be available from the response parameter item_id.
Note: Duplicate IDs are not supported. | |
| listing_ids | body | string[] | No | Required for product listings in an online-to-offline catalog.
Listing IDs of product listings that you want to delete.
Max size: 10,000.
To obtain listing IDs for product listings in an online-to-offline catalog, use /catalog/product/get/. The listing IDs will be available from the response parameter listing_id.
Note: Duplicate listing IDs are not supported. | |
| feed_id | body | string | No | Feed ID. If the value of this field is empty, the default catalog will be processed. |
Request examples
curl -s -X POST "https://partner.quantri360.com/v1/tiktok_business/catalog/product/delete/" \
-H "Authorization: Bearer $KEY" \
-H "Content-Type: application/json" \
-d '{"bc_id":"","catalog_id":""}'
Python
import requests
KEY = "q360_live_..." # khóa API của brand
r = requests.post(
"https://partner.quantri360.com/v1/tiktok_business/catalog/product/delete/",
params={},
json={
"bc_id": "",
"catalog_id": ""
},
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/catalog/product/delete/');
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({"bc_id":"","catalog_id":""}),
});
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/catalog/product/delete/' . '?' . 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, '{"bc_id":"","catalog_id":""}');
$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 Business)
| Name | Type | Sample | Description |
|---|---|---|---|
| code | number | Return code, see Appendix - return code. | |
| message | string | Return message, see Appendix-Return message. | |
| request_id | string | The log id of a request, which uniquely identifies the request. | |
| data | object | Returned data. | |
| feed_log_id | string | Product handling log ID. |
Response sample
HTTPS/1.1 200 OK
{
"message": "OK",
"code": 0,
"data": {
"feed_log_id": "73474"
},
"request_id": "2020091405212201023125321410665"
}
(/code);
Get started
- Sign up for Partner
- Enable a data type of the Ads (Marketing API) group on the platform page
- Create an API key (tick the TikTok Business channel)
- Call it as in the examples above