tebarDocs
GuideDevelopersAPI ReferenceChangelog
Accounts

List TikTok music

GET
/v1/accounts/{id}/tiktok/music

TikTok business accounts only: up to 100 popular pre-cleared tracks of the Commercial Music Library, { data: [{ id, title, artist, duration_s, genres, preview_url, cover_url, rank }] }, for a video's options.tiktok.music.id. Filter by genre, period (1d, 7d, 30d, 90d) and country (default ID). q finds a title or artist: TikTok has no music search for organic posts, so it is matched against every genre's popular list (or genre's, if set) for that country and period, title matches first; period 90d covers the most. Cached an hour. Other TikTok accounts: 422 tiktok_music_unavailable; other platforms: 400 not_tiktok.

Requires the read scope.

Authorization

bearer
headerAuthorizationBearer <token>

An API key (tb_live_...) from the dashboard, or an OAuth access token.

Path Parameters

id*string
Formatuuid

Query Parameters

genre?string
Default"ALL"
Value in"ALL""POP""HIP_HOP/RAP""ELECTRONIC""R&B/SOUL""ROCK""METAL""BLUES""ALTERNATIVE/INDIE""JAZZ""CLASSICAL""COUNTRY""FOLK""LATIN""REGGAE""EASY_LISTENING""NEW_AGE""WORLD_MUSIC""CHILDHOOD"
period?string
Default"7d"
Value in"1d""7d""30d""90d"
country?string
Match^[A-Za-z]{2}$
q?string
Length1 <= length <= 100

Header Parameters

Tebar-Profile?string

Limits an owner key to one profile (id or external_id). Unknown: 404 profile_not_found.

Response Body

The tracks, most popular first.

Example Request
curl -X GET 'https://api.tebar.app/v1/accounts/497f6eca-6276-4993-bfeb-53cbbbba6f08/tiktok/music'
Example Response
Empty

Get TikTok posting settings GET

TikTok accounts only: privacy options, interactions the creator turned off, maximum video length, video_public_only, and can_post (from TikTok, cached 1 minute). Show these before posting to TikTok. Requires the read scope.

List Pinterest boards GET

Pinterest accounts only: boards a Pin can be saved to, [{ id, name, privacy }]. Cached 10 minutes; refresh=1 reads Pinterest again. Other accounts: 400 not_pinterest. Requires the read scope.