API referenceTikTok Business

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

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

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

Authorization

BearerAuth
headerAuthorizationBearer <token>

API key sk_...

Path Parameters

id*string

Account id

postId*string

TikTok post id, or a Postgale post id published to this account

Response Body

{accountId, platform, authorization}

application/json
  1. response
accountId?string
platform?string
authorization?
Example Request
curl -X GET 'https://example.com/api/v1/accounts/string/tiktok-business/posts/string/ad-authorization'
Example Response
{  "accountId": "string",  "platform": "string",  "authorization": {    "postId": "string",    "enabled": true,    "authCode": "string",    "status": "string",    "startTime": "string",    "endTime": "string",    "days": 0  }}

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

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

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

Enables (/business/post/authorize/setting/, days 7, 30, 60, 180 or 365, default 30), extends (/business/post/authorize/) or disables the "Ad authorization" of a post so an advertiser can run it as a Spark Ad. Needs biz.spark.auth. Queued for approval (202) while approval applies