Get identities with Showcase permission under an ad account
GET/showcase/identity/get/Via 360: GET https://partner.quantri360.com/v1/tiktok_business/showcase/identity/get/
Description
Use this endpoint to get identities with Showcase permission under an ad account.
Note that only identities with Showcase permission can be used to create Video Shopping Ads with products from Showcase. See here to learn more about the detailed steps.
Request
Endpoint
GET https://partner.quantri360.com/v1/tiktok_business/showcase/identity/get/
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
No specific parameters (besides the common ones).
Request examples
curl -s "https://partner.quantri360.com/v1/tiktok_business/showcase/identity/get/" \ -H "Authorization: Bearer $KEY"
Python
import requests
KEY = "q360_live_..." # khóa API của brand
r = requests.get(
"https://partner.quantri360.com/v1/tiktok_business/showcase/identity/get/",
params={},
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/showcase/identity/get/');
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: 'GET',
headers: { Authorization: `Bearer ${KEY}` },
});
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/showcase/identity/get/' . '?' . http_build_query([]); $ch = curl_init($url); curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); curl_setopt($ch, CURLOPT_HTTPHEADER, ['Authorization: Bearer ' . $key]); $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 | Response code. For the complete list of response codes and descriptions, see Appendix-Return Code. | |
| message | string | Response message. For details, see Appendix - Return Codes. | |
| request_id | string | The log ID of a request, which uniquely identifies the request. | |
| data | object | Returned data. | |
| identity_list | object[] | The list of identities with Showcase permission. | |
| identity_id | string | The ID of the identity that the Showcase is bound to. | |
| identity_type | string | Identity type. Enum values: - `TT_USER`: TikTok User. - `BC_AUTH_TT`: TikTok Account User in Business Center. See Identities to learn more about different identity types. | |
| identity_authorized_bc_id | string | Returned when `identity_type` is `BC_AUTH_TT`. ID of the Business Center that a Showcase, which is bound to a TikTok Account User in Business Center identity, is associated with. |
Response sample
HTTPS/1.1 200 OK
{
"code": 0,
"message": "OK",
"request_id": "{{request_id}}",
"data": {
"identity_list": [
{
"identity_type": "BC_AUTH_TT",
"identity_id": "{{identity_id}}",
"identity_authorized_bc_id": "{{identity_authorized_bc_id}}"
},
{
"identity_type": "BC_AUTH_TT",
"identity_id": "{{identity_id}}",
"identity_authorized_bc_id": "{{identity_authorized_bc_id}}"
}
]
}
}
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