API referenceTikTok Business

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

Popular Commercial Music Library tracks for a post's sound (/discovery/cml/trending_list/, up to 100): pass a track id as musicSoundId. TikTok filters by genre, countryCode and dateRange only; query narrows the returned list by name or artist

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

Authorization

BearerAuth
headerAuthorizationBearer <token>

API key sk_...

Path Parameters

id*string

Account id

Query Parameters

genre?string

TikTok genre value, e.g. ALL, POP, HIP_HOP/RAP (default ALL)

countryCode?string

Two-letter country code (default US)

dateRange?string

1DAY, 7DAY, 30DAY or 90DAY (default 7DAY)

query?string

Filter the list by track name or artist

Response Body

{accountId, platform, tracks, note}

application/json
  1. response
accountId?string
platform?string
tracks?array<>
note?string
Example Request
curl -X GET 'https://example.com/api/v1/accounts/string/tiktok-business/music'
Example Response
{  "accountId": "string",  "platform": "string",  "tracks": [    {      "id": "string",      "trackId": "string",      "name": "string",      "artist": "string",      "durationSec": 0,      "previewUrl": "string",      "thumbnailUrl": "string",      "genres": [        "string"      ],      "rank": 0    }  ],  "note": "string"}

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

Recommended hashtags for a keyword (/business/hashtag/suggestion/): 10 hashtags, exact matches first, then by number of posts (without suggestions TikTok returns the keyword with postCount 0)

GET /api/v1/accounts/{id}/tiktok-business/posts/{postId}/ad-authorization GET

Spark Ads authorization status of a post (/business/post/authorize/status/, needs biz.spark.auth): the authorization code, its status and validity. TikTok answers an error when the post has no code