Get the sharing log of an audience
GET/dmp/custom_audience/share/log/Via 360: GET https://partner.quantri360.com/v1/tiktok_business/dmp/custom_audience/share/log/
Description
Use this endpoint to get the sharing log of an audience. The information in the log includes the advertiser IDs and names that the audience has been shared with.
Request
Endpoint
GET https://partner.quantri360.com/v1/tiktok_business/dmp/custom_audience/share/log/
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 |
|---|---|---|---|---|---|
| custom_audience_id | query | string | Yes | Custom audiences that you want to get sharing log for. |
Request examples
curl -s "https://partner.quantri360.com/v1/tiktok_business/dmp/custom_audience/share/log/?custom_audience_id=" \ -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/dmp/custom_audience/share/log/",
params={
"custom_audience_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/dmp/custom_audience/share/log/');
for (const [k, v] of Object.entries({"custom_audience_id":""})) 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/dmp/custom_audience/share/log/' . '?' . http_build_query(['custom_audience_id' => '']); $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 | Return code, see Appendix-Return Codes. | |
| message | string | Return message, see Appendix-Return Codes. | |
| data | object | Returned data. | |
| list | object[] | A list of Audience. | |
| shared_advertiser_id | string | ID of the advertiser that the audience is shared with. | |
| shared_advertiser_name | string | Name of the advertiser that the audience is shared with. | |
| custom_audience_id | string | ID of the audience that you want to get sharing log for. | |
| status | string | Audience status. | |
| request_id | string | The log id of a request, which uniquely identifies the request. |
Response sample
HTTPS/1.1 200 OK
{
"message": "OK",
"code": 0,
"data": {}
}
(/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