TikTok Profile API

Follower, video and heart counts for a public TikTok account.

EndpointGET /v1/tiktok/profile
Cost1 credit live
Cache hit0 credits
ReturnsOne object

Call it

curl -G 'https://api.sourcevine.io/v1/tiktok/profile' \
  -H 'Authorization: Bearer sv_live_...' \
  --data-urlencode 'url=https://www.tiktok.com/@username'
const res = await fetch(
  'https://api.sourcevine.io/v1/tiktok/profile?' + new URLSearchParams({
    url: 'https://www.tiktok.com/@username',
  }),
  { headers: { Authorization: 'Bearer sv_live_...' } },
);
const { success, data } = await res.json();
import requests

r = requests.get(
    "https://api.sourcevine.io/v1/tiktok/profile",
    params={"url": "https://www.tiktok.com/@username"},
    headers={"Authorization": "Bearer sv_live_..."},
)
data = r.json()["data"]

Parameters

NameRequiredNotes
urlYesA public TikTok URL.
access_keyYesYour key. Send it as Authorization: Bearer orx-access-key where you can — a key in a query string ends up in proxy logs and browser history.
cacheNoDefaults to true. Set false to force a live read, which always costs credits.

Billing

A live read costs 1 credit and a cache hit costs nothing. Every response says which it was, in thecached field and in the X-Credits-Chargedheader. A resource that turns out to be private, deleted, or that we could not reach is never charged.

Other APIs

All APIs →