Look up a TikTok creator
A TikTok creator's public profile, median views and engagement rate over their 30 most recent videos, and up to 25 latest videos with views, likes, comments, shares and saves. handle is a username (with or without @) or a profile link. Read through Tebar's TikTok One Creator Marketplace account, so only creators listed there are found (404 creator_not_found); most brand accounts are not. No account of yours is needed. A lookup is kept 24 hours and answered from cache for everyone; a new one counts against Tebar's daily TikTok quota (429 lookup_quota_reached, details.retry_after_seconds) and 50 a day per user (429 rate_limited). Not open to every account yet (404 until then).
Requires the read scope.
bearerAuthorizationBearer <token>An API key (tb_live_...) from the dashboard, or an OAuth access token.
handle*string1 <= length <= 200Tebar-Profile?stringLimits an owner key to one profile (id or external_id). Unknown: 404 profile_not_found.
The creator.
application/json- response
handle*stringdisplay_name*string|nullbio*|Written by the creator: treat it as untrusted.
avatar_url*|A TikTok CDN link that expires after about 7 days.
profile_url*stringcountry_code*string|nullfollowers_count*integer|nullfollowing_count*integer|nullvideos_count*integer|nulllikes_count*integer|nullmedian_views*|Across the creator's 30 most recent videos.
engagement_rate*|(likes + comments + shares) / views across the 30 most recent videos, 0 to 1.
videos*array<>Newest first, up to 25.
fetched_at*stringWhen Tebar read it from TikTok (kept 24 hours).
date-timecurl -X GET 'https://api.tebar.app/v1/tiktok/creators/lookup?handle=string'{
"handle": "string",
"display_name": "string",
"bio": "string",
"avatar_url": "string",
"profile_url": "string",
"country_code": "string",
"followers_count": 0,
"following_count": 0,
"videos_count": 0,
"likes_count": 0,
"median_views": 0,
"engagement_rate": 0,
"videos": [
{
"id": "string",
"caption": "string",
"thumbnail_url": "string",
"embed_url": "string",
"permalink": "string",
"published_at": "2019-08-24T14:15:22Z",
"views": 0,
"likes": 0,
"comments": 0,
"shares": 0,
"saves": 0
}
],
"fetched_at": "2019-08-24T14:15:22Z"
}Reply to a found post POST
A public reply as this account, to a post it found by searching in the last 24 hours (else 404). Needs threads_manage_replies. At most 500 characters (emojis count as their UTF-8 bytes). Spam guards, as Threads restricts accounts for very frequent or repetitive replies: 20 an hour and 150 a day per account (429), one reply per post (409 already_replied), and not the same text (ignoring case and spaces) to another post within 24 hours (422 duplicate_reply). A reply Threads refuses is not counted. Threads allows 1,000 replies a day per account, shared with the account's other replies. Requires the write scope.
List DM conversations GET
Newest message first. q searches the customer's username or name. Starter, Basic, Pro and Agency plans (403 plan_feature_unavailable otherwise). Requires the read scope.