Developer resources

Get the available TikTok Series within an ad account — TikTok Business API

Get the available TikTok Series within an ad account · 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

Get the available TikTok Series within an ad account

GET/identity/native_series/get/Via 360: GET https://partner.quantri360.com/v1/tiktok_business/identity/native_series/get/

Description

Use this endpoint to retrieve a list of available TikTok Series from a specified TikTok account (identity) that can be promoted by an ad account.

Series offers exclusive and premium video packages produced by creators. Access to Series is available to purchase through the creator's profile and links attached to TikTok videos.

> Note

> If you would like to create TikTok Series within your TikTok account, please contact your TikTok representative.

Request

Endpoint

GET https://partner.quantri360.com/v1/tiktok_business/identity/native_series/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

Name	In	Type	Required	Description
identity_id	query	string	Yes	Identity ID. To get the list of identities under your ad account, use /identity/get/.
identity_type	query	string	Yes	Identity type. Enum values: `TT_USER`, `BC_AUTH_TT`. See Identities for details.
identity_authorized_bc_id	query	string	No	Required when `identity_type` is `BC_AUTH_TT`. ID of the Business Center that a TikTok Account User in Business Center identity is associated with.
cursor	query	integer	No	The cursor for paginating results. If `has_more` in the response is `true`, use the returned cursor in your subsequent request to fetch the next set of data. Default value: 0.
count	query	number	No	The maximum number of Series to return in the response. Value range: 1-20. Default value: 10.

Request examples

curl -s "https://partner.quantri360.com/v1/tiktok_business/identity/native_series/get/?identity_id=&identity_type=" \
  -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/identity/native_series/get/",
    params={
        "identity_id": "",
        "identity_type": ""
    },
    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/identity/native_series/get/');
for (const [k, v] of Object.entries({"identity_id":"","identity_type":""})) 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/identity/native_series/get/' . '?' . http_build_query(['identity_id' => '', 'identity_type' => '']);
$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	Description
code	number	Response code. For the complete list of response codes and descriptions, see Appendix - Return Codes.
message	string	Response message. For details, see Appendix - Return Codes.
request_id	string	The log ID of the request, which uniquely identifies a request.
data	object	Returned data.
list	object[]	The list of Series that you can access from the identity (`identity_id`).
native_series_id	string	The ID of the TikTok Series.
native_series_name	string	The name of the TikTok Series.
native_series_cover_url	string	The URL to the cover image of the TikTok Series.
native_series_total_episode	number	The total number of episodes in the TikTok Series.
native_series_total_duration	number	The combined duration of all episodes in the TikTok Series, measured in seconds.
cursor	integer	The cursor for paginating results. If `has_more` in the response is `true`, use this cursor in your subsequent request to fetch the next set of data.
has_more	boolean	Whether more data is available.

Response sample

{
    "code": 0,
    "message": "OK",
    "request_id": "{{request_id}}",
    "data": {
        "cursor": {{cursor}},
        "has_more": false,
        "list": [
            {
                "native_series_cover_url": "{{native_series_cover_url}}",
                "native_series_id": "{{native_series_id}}",
                "native_series_name": "{{native_series_name}}",
                "native_series_total_duration": 31,
                "native_series_total_episode": 2
            },
            {
                "native_series_cover_url": "{{native_series_cover_url}}",
                "native_series_id": "{{native_series_id}}",
                "native_series_name": "{{native_series_name}}",
                "native_series_total_duration": 153,
                "native_series_total_episode": 6
            },
            {
                "native_series_cover_url": "{{native_series_cover_url}}",
                "native_series_id": "{{native_series_id}}",
                "native_series_name": "{{native_series_name}}",
                "native_series_total_duration": 84,
                "native_series_total_episode": 1
            },
            {
                "native_series_cover_url": "{{native_series_cover_url}}",
                "native_series_id": "{{native_series_id}}",
                "native_series_name": "{{native_series_name}}",
                "native_series_total_duration": 84,
                "native_series_total_episode": 1
            },
            {
                "native_series_cover_url": "{{native_series_cover_url}}",
                "native_series_id": "{{native_series_id}}",
                "native_series_name": "{{native_series_name}}",
                "native_series_total_duration": 116,
                "native_series_total_episode": 1
            },
            {
                "native_series_cover_url": "{{native_series_cover_url}}",
                "native_series_id": "{{native_series_id}}",
                "native_series_name": "{{native_series_name}}",
                "native_series_total_duration": 147,
                "native_series_total_episode": 2
            },
            {
                "native_series_cover_url": "{{native_series_cover_url}}",
                "native_series_id": "{{native_series_id}}",
                "native_series_name": "{{native_series_name}}",
                "native_series_total_duration": 179,
                "native_series_total_episode": 2
            },
            {
                "native_series_cover_url": "{{native_series_cover_url}}",
                "native_series_id": "{{native_series_id}}",
                "native_series_name": "{{native_series_name}}",
                "native_series_total_duration": 28,
                "native_series_total_episode": 1
            }
        ]
    }
}

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