Overview
What teams build with the TikTok API
Creator vetting
Check an account's followers, total likes, and post count before a partnership, and re-check them on a schedule.
Campaign reporting
Track views, likes, comments, shares, and saves on the posts a campaign paid for, from the post links alone.
Content research
Collect captions, hashtags, sounds, and posting times of the posts you follow, and compare how they perform.
Official API restricted
Does TikTok have an official API for public posts and profiles?
Not for businesses reading other accounts. The Research API excludes commercial users, and the Display API reads only users who sign in to your app.
TikTok's Research API answers "No" to whether creators, advertisers, or commercial users are eligible. The Display API returns a user's profile and videos after that user grants your app the user.info.basic and video.list permissions, so it cannot look up an account that has not signed in.
Clair reads the page TikTok shows any signed-out visitor for a public post or account and returns it as JSON. The video list and comments are not on that page, so Clair does not return them.
Read from these pages on October 28, 2026.
Data samples
From the page to JSON
The page the TikTok API reads, and the response it returns for the same query.
video_id
6718335390845095173
https://www.tiktok.com/@scout2015/video/6718335390845095173?lang=en

{
"engine": "tiktok",
"family": "video",
"query": {
"video_id": "6718335390845095173"
},
"video": {
"video_id": "6718335390845095173",
"url": "https://www.tiktok.com/@scout2015/video/6718335390845095173",
"type": "video",
"description": "Scramble up ur name & I’ll try to guess it😍❤️ #foryoupage #petsoftiktok #aesthetic",
"published_at": "2019-07-27T13:32:38.000Z",
"duration_ms": 10000,
"cover": "https://p19-common-sign.tiktokcdn-us.com/tos-maliva-p-0068/2367c7d45cf54a1397abd0e72bf22eac~tplv-tiktokx-origin.image?dr=9636&x-expires=1793311200&x-signature=atz8K8hQqgXu8e4hOhmNomXtkdw%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=useast8",
"images": [],
"hashtags": [
"foryoupage",
"petsoftiktok",
"aesthetic"
],
"mentions": [],
"language": "en",
"country": "US",
"is_ad": false,
"ai_generated": false,
"views_count": 159700,
"likes_count": 35200,
"comments_count": 5843,
"shares_count": 1518,
"saves_count": 649,
"reposts_count": 0,
"author": {
"user_id": "53279706535428096",
"username": "scout2015",
"nickname": "Scout, Suki & Stella",
"verified": true,
"avatar": "https://p16-common-sign.tiktokcdn-us.com/tos-useast8-avt-0068-tx2/4cbe05e194623e3f19aef975d9fdf26c~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=9640&refresh_token=7f0c927a&x-expires=1793311200&x-signature=5DMld5asM%2F1NWqWEVb5cYo6sHT0%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=useast8",
"url": "https://www.tiktok.com/@scout2015",
"followers_count": 9000000,
"likes_count": 108300000,
"videos_count": 3079
},
"music": {
"music_id": "6689804660171082501",
"title": "original sound",
"author": "tiff",
"original": true,
"duration_ms": 10000
}
}
}Source page captured separately from the recorded response, so live values can differ.
Code
Integrate in minutes
One host, one Bearer key for every Clair API. Each call returns JSON with the same envelope, so a second API is a new path, not a new client.
curl -G "https://api.clair.im/v1/tiktok/video?video_id=6718335390845095173" \ -H "Authorization: Bearer YOUR_API_KEY"
Reference
Query and response fields
video_id takes the post id or a tiktok.com/@user/video/ or /photo/ link. Share links (vm.tiktok.com, tiktok.com/t/) hide the id: open one and pass the address it lands on. Counts are as the post page shows them, which rounds large numbers (35,200 likes). A post that is gone or never existed returns 404.
GET /v1/tiktok/video
Authorizationheader · stringrequired
- Bearer <api_key>. Create keys under API keys.
video_idstringrequired
- The post id, such as
6718335390845095173, or a tiktok.com/@user/video/ or /photo/ link.
Pricing
What can I pass as video_id?
The post id, such as 6718335390845095173, or a tiktok.com/@user/video/ or /photo/ link. Share links such as vm.tiktok.com hide the id: open one and pass the address it lands on.
Are the counts exact?
Profile counts are. Post pages round large numbers, so a post shows 35,200 likes rather than the exact figure; Clair returns what the page shows.
Can I get an account's videos, comments, or search results?
No. None of them is on the page TikTok serves for a post or an account; a browser loads them afterwards with signed requests. Clair returns what the page carries.
Do photo posts work?
Yes. They come back with type photo, the images in order, and no duration.
How long do image links work?
About two days. TikTok signs cover, image, and avatar links with an expiry; download the ones you want to keep.
What does the TikTok API return?
Reads the logged-out page of a public TikTok post, by id or link, or of an account, by username. A post comes back with its views, likes, comments, shares, saves, caption, hashtags, sound, and author; photo posts include their images. A profile comes back with its followers, likes, video count, bio, and link. The page TikTok serves carries no video list or comments, so there are none here.
Which endpoints does a plan include?
All of them: Post, Profile. Each call spends this API's rate from your plan's balance.
How is a request counted?
Each call is one request, and each extra page is a new call. A malformed request (400) is not counted, and a request that fails on our side (5xx) is refunded.
Is there a free tier?
Yes. The free tier is $1 of usage a month across every Clair API, with no card: about 303 TikTok API requests if it all goes here. It resets monthly, and calls stop when the balance runs out.
What happens when I use up my plan's balance?
The API returns 429 until the next period, on every plan, and nothing is billed past the balance. An upgrade starts a new month at once, and the unused balance carries over.
Does my plan cover other Clair APIs?
Yes. One plan and one key cover every Clair API, and every call spends from the same monthly balance. Your first call starts the free tier.
Related
Related APIs
APIs teams often combine with the TikTok API.
One plan, every API.
Your plan's price is your monthly usage balance, spent across every Clair API. Start free, no card.

Glassdoor API
Crunchbase API
Bloomberg API
Associated Press API