List TikTok Business music

GET

/accounts/{id}/tiktok-music

curl --request GET \
  --url https://postflow.biz.id/api/v1/accounts/example/tiktok-music \
  --header 'Authorization: Bearer <token>'

Trending Commercial Music Library tracks for options.tiktok.music. TikTok Business accounts only.

Authorizations

• apiKey
• oauth

Parameters

Path Parameters

id

required

string

TikTok Business account id

Query Parameters

genre

string

Responses

200

OK

Media typeapplication/json

object

tracks

required

Array<object>

object

id

required

Use as options.tiktok.music.id.

string

title

required

string

artist

required

string

coverUrl

required

Any of:

string

string

null

null

previewUrl

required

Any of:

string

string

null

null

durationSec

required

Any of:

integer

integer

null

null

Example ^generated

{
  "tracks": [
    {
      "id": "example",
      "title": "example",
      "artist": "example",
      "coverUrl": "example",
      "previewUrl": "example",
      "durationSec": 1
    }
  ]
}

401

Missing, invalid, expired or deleted key or token.

Media typeapplication/json

object

error

required

object

code

required

string

Allowed values: UNAUTHENTICATED FORBIDDEN NOT_FOUND VALIDATION CONFLICT SUBSCRIPTION_GRACE SUBSCRIPTION_EXPIRED PLAN_LIMIT RATE_LIMITED INTERNAL

message

required

A sentence you can show to a person.

string

details

Field errors ({ field: [messages] }), or preflight: per-account rule violations with an issue code.

Example

{
  "error": {
    "code": "UNAUTHENTICATED"
  }
}

404

Not found in this workspace.

Media typeapplication/json

object

error

required

object

code

required

string

Allowed values: UNAUTHENTICATED FORBIDDEN NOT_FOUND VALIDATION CONFLICT SUBSCRIPTION_GRACE SUBSCRIPTION_EXPIRED PLAN_LIMIT RATE_LIMITED INTERNAL

message

required

A sentence you can show to a person.

string

details

Field errors ({ field: [messages] }), or preflight: per-account rule violations with an issue code.

Example

{
  "error": {
    "code": "UNAUTHENTICATED"
  }
}

409

Conflict, e.g. the post is publishing right now, or the platform refused the action.

Media typeapplication/json

object

error

required

object

code

required

string

Allowed values: UNAUTHENTICATED FORBIDDEN NOT_FOUND VALIDATION CONFLICT SUBSCRIPTION_GRACE SUBSCRIPTION_EXPIRED PLAN_LIMIT RATE_LIMITED INTERNAL

message

required

A sentence you can show to a person.

string

details

Field errors ({ field: [messages] }), or preflight: per-account rule violations with an issue code.

Example

{
  "error": {
    "code": "UNAUTHENTICATED"
  }
}

429

More than 120 requests in a minute with this key.

Media typeapplication/json

object

error

required

object

code

required

string

Allowed values: UNAUTHENTICATED FORBIDDEN NOT_FOUND VALIDATION CONFLICT SUBSCRIPTION_GRACE SUBSCRIPTION_EXPIRED PLAN_LIMIT RATE_LIMITED INTERNAL

message

required

A sentence you can show to a person.

string

details

Field errors ({ field: [messages] }), or preflight: per-account rule violations with an issue code.

Example

{
  "error": {
    "code": "UNAUTHENTICATED"
  }
}