API referenceTikTok Business

GET /api/v1/accounts/{id}/tiktok-business/videos

The account's public posts, newest first (/business/video/list/, needs video.list), with views, likes, comments, shares, saves and reach, plus watch time, retention, impression sources and audience breakdowns with video.insights. videoIds reads up to 20 specific posts

GET
/api/v1/accounts/{id}/tiktok-business/videos

Authorization

BearerAuth
headerAuthorizationBearer <token>

API key sk_...

Path Parameters

id*string

Account id

Query Parameters

cursor?string

nextCursor from the previous page

limit?integer

Maximum items (default 20, max 20)

Range1 <= value <= 20
Default20
videoIds?string

Comma-separated post ids (max 20) instead of listing

Response Body

{accountId, platform, videos, nextCursor?, hasMore}

application/json
  1. response
accountId?string
platform?string
videos?array<>
nextCursor?string

Pass as cursor for the next page

hasMore?boolean
Example Request
curl -X GET 'https://example.com/api/v1/accounts/string/tiktok-business/videos'
Example Response
{  "accountId": "string",  "platform": "string",  "videos": [    {      "id": "string",      "mediaType": "string",      "caption": "string",      "createTime": "string",      "durationSec": 0,      "thumbnailUrl": "string",      "shareUrl": "string",      "embedUrl": "string",      "isAd": true,      "metrics": {},      "breakdowns": {}    }  ],  "nextCursor": "string",  "hasMore": true}

GET /api/v1/accounts/{id}/tiktok-business/settings GET

The account's post settings (/business/video/settings/) in creator-info form, to read before each post: privacy levels (photo posts; videos are always PUBLIC_TO_EVERYONE), interactions the account disabled, max video length

GET /api/v1/accounts/{id}/tiktok-business/locations GET

Location tags for a post (/business/publish/location/, max 20): pass id and name as locationId and locationName in the post's platformSpecificData