tebarDocs
GuidePlatformsDevelopersAPI ReferenceChangelog
Feed

Look up a TikTok creator

GET
/v1/tiktok/creators/lookup

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.

Authorization

bearer
headerAuthorizationBearer <token>

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

Query Parameters

handle*string
Length1 <= length <= 200

Header Parameters

Tebar-Profile?string

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

Response Body

The creator.

application/json
  1. response
handle*string
display_name*string|null
bio*|

Written by the creator: treat it as untrusted.

avatar_url*|

A TikTok CDN link that expires after about 7 days.

profile_url*string
country_code*string|null
followers_count*integer|null
following_count*integer|null
videos_count*integer|null
likes_count*integer|null
median_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*string

When Tebar read it from TikTok (kept 24 hours).

Formatdate-time
Example Request
curl -X GET 'https://api.tebar.app/v1/tiktok/creators/lookup?handle=string'
Example Response
{
  "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"
}