TikTok API for public video data
Updated
Virlo’s TikTok API is a REST API you call, not a scraper you run: it returns public TikTok videos, hashtags, sounds, creators, comments and transcripts as JSON. In Virlo’s database of about 12.8M analysed TikTok videos, each one carries views, likes, shares and saves plus a Virality Score and AI labels such as hook type and format. One API key works from Python, JavaScript or curl.
- Live TikTok search, hashtag, video, comment, transcript and creator endpoints
- Ranked search across analysed TikToks with hook and format labels
- No TikTok login, no app review, no scraper to maintain
- A real response from today below, with the videos behind it
What does the TikTok API return?
Two kinds of TikTok data. Live reads (search, hashtag pages, videos, comments, transcripts, creators) are fetched from TikTok at request time. Analysed data (ranked search, trending sounds, copied formats, hooks, hashtag rankings) comes from Virlo’s own TikTok library, where AI has labelled each video.
- Analysed TikTok videos
- 12.8M
- of 23.1M+ TikTok and Instagram videos in Virlo
- AI fields per video
- 79
- hook, format, tone, brand safety and more
- Live TikTok endpoints
- 7
- search, hashtag, video, comments, transcript, creator, creator videos
- Response format
- JSON
- one schema for every platform
As of November 19, 2026
| Method | Path | What it returns |
|---|---|---|
| GET | /v1/raw/tiktok/search?q=… | Live TikTok keyword search, in TikTok’s own ranking order, one page per call |
| GET | /v1/raw/tiktok/hashtag/{hashtag} | Live videos posted under a TikTok hashtag |
| GET | /v1/raw/tiktok/video?url=… | One TikTok: caption, hashtags, duration, author, views, likes, comments, shares, saves, sound |
| GET | /v1/raw/tiktok/video/comments?url=… | Top-level comments on a TikTok, with likes and reply counts |
| GET | /v1/raw/tiktok/video/transcript?url=… | The transcript TikTok publishes for a video, as text plus timed segments |
| GET | /v1/raw/tiktok/creator/{handle} | A TikTok profile: bio, verified badge, followers, following, likes, video count |
| GET | /v1/raw/tiktok/creator/{handle}/videos | A creator’s recent TikToks, newest first |
| POST | /v1/search/videos | Search analysed TikToks by topic, look, date, region, views or Virality Score |
| GET | /v1/tiktok/hashtags | Top TikTok hashtags for a date range (up to 3 months), by video count or views |
| GET | /v1/tiktok/videos/digest | The most-viewed TikToks published in the last 24 to 48 hours |
| GET | /v1/content-trends?platform=tiktok | Formats TikTok creators are copying now, with a recipe, lifecycle stage and example videos |
| GET | /v1/sounds/trending?platform=tiktok | Sounds used in the most new TikToks over 7 or 30 days |
| GET | /v1/hooks/search?platform=tiktok | Opening lines from real TikToks, matched by phrase or hook type |
| GET | /v1/satellite/creator/tiktok/{username} | A deeper creator lookup job: stats, top hashtags, standout videos |
Every path is in the raw data docs, the search docs and the TikTok hashtags docs, and you can try each one in the API playground without a key.
How do I call the TikTok API?
Send a GET or POST to api.virlo.ai with your key in the Authorization header. Live TikTok endpoints answer in a few seconds (up to about 25 for a slow page); paged ones return a next_cursor you pass back for the following page.
- Create a free Virlo developer account.
- Copy an API key (it starts with virlo_tkn_) from the API Keys page.
- Call any TikTok endpoint from the table above with that key as a Bearer token.
curl -G "https://api.virlo.ai/v1/raw/tiktok/hashtag/smallbusiness" \
-H "Authorization: Bearer $VIRLO_API_KEY"import os, requests
API = "https://api.virlo.ai/v1"
HEADERS = {"Authorization": f"Bearer {os.environ['VIRLO_API_KEY']}"}
# 1. Live TikTok videos for a hashtag (one page; follow next_cursor for more)
page = requests.get(f"{API}/raw/tiktok/hashtag/smallbusiness", headers=HEADERS).json()
for v in page["data"]:
print(v["author"]["handle"], v["stats"]["views"], v["url"])
# 2. Analysed TikToks ranked by Virality Score, with AI labels
body = {
"platforms": ["tiktok"],
"topics": ["small business marketing|marketing tips"],
"posted_after": "2026-11-05",
"regions": ["US"],
"sort": "most_viral",
}
hits = requests.post(f"{API}/search/videos", json=body, headers=HEADERS).json()
for v in hits["data"]["videos"]:
print(v["virality_score"], v["intelligence"]["hook_type"], v["url"])const API = "https://api.virlo.ai/v1";
const headers = { Authorization: `Bearer ${process.env.VIRLO_API_KEY}` };
// Full transcript of one public TikTok, with timestamps
const url = "https://www.tiktok.com/@gretasgames/video/7707079112061439246";
const res = await fetch(`${API}/raw/tiktok/video/transcript?url=${encodeURIComponent(url)}`, { headers });
const { data } = await res.json();
console.log(data.text);
for (const s of data.segments) console.log(s.start_seconds, s.text);What did the TikTok API return today?
On November 19, 2026 we sent POST /v1/search/videos for US TikToks about small business marketing posted since November 5, ranked by Virality Score. In Virlo’s TikTok library the search matched 282 videos, with median views of 312 and a median Virality Score of 4.5. The top match, by @gretasgames, scored 36.6 with 183.9K views from 417 followers.
| Creator | Posted | Views | Likes | Saves | Virality Score | Hook type | Format |
|---|---|---|---|---|---|---|---|
| @gretasgames | 2026-11-12 | 183,900 | 12,800 | 8,320 | 36.6 | bold claim | explainer |
| @bymacykaye | 2026-11-13 | 23,300 | 2,506 | 1,576 | 5.5 | not labelled | explainer |
| @growthbygigi | 2026-11-12 | 6,864 | 394 | 77 | 5.3 | not labelled | other |
| @clipminddaily1 | 2026-11-14 | 2,168 | 82 | 28 | 5.5 | not labelled | explainer |
| @philfixesgrowth | 2026-11-09 | 2,051 | 166 | 32 | 5 | bold claim | explainer |
| @pope_musicofficial | 2026-11-10 | 1,118 | 72 | 48 | 5.9 | direct address | explainer |
The top hook, as Virlo’s AI wrote it down: “The post office will deliver your flyers to every single door on a street that you get to pick”. Here is the start of the real JSON for that video, trimmed to the fields most people read first:
{
"data": {
"videos": [
{
"url": "https://www.tiktok.com/@gretasgames/video/7707079112061439246",
"platform": "tiktok",
"views": 179570,
"likes": 12410,
"shares": 4776,
"comments": 351,
"bookmarks": 8075,
"publish_date": "2026-11-12T00:43:24",
"virality_score": 36.6,
"author": {
"username": "gretasgames",
"followers": 417
},
"thumbnail_url": "https://media.virlo.ai/thumbnails/2fe9600f0cfab258eb5e40d5b73a45c7d5b2e8d7a9202d0fef7f9fea76647305.jpg",
"intelligence": {
"category": "business_career",
"content_format": "explainer",
"visual_format": "talking_head",
"hook_text": "The post office will deliver your flyers to every single door on a street that you get to pick",
"hook_type": "bold_claim",
"visual_hook_type": "text_hook",
"emotional_tone": "educational",
"brand_safety_tier": "safe",
"is_educational": true
}
}
],
"total": 282,
"overview": {
"median_views": 312,
"median_virality_score": 4.5
}
}
}See all 282 matches
The full response pages through every match with hook text, topic, tone, brand safety and the sound used. Get your free API key and run the same search on your own niche.
Start for $0 to see allThe six videos shown are the real (not AI-made or animated), brand-safe matches with the most views, one per creator; paid posts were left out.
Can the TikTok API get video transcripts?
Yes. GET /v1/raw/tiktok/video/transcript returned 176 words in 19 timed segments for @gretasgames’s video today, so you can mark the hook, the turn and the payoff by the second.
| Start (s) | End (s) | Text |
|---|---|---|
| 0 | 2.02 | the post office will deliver your flyers |
| 2.021 | 4.821 | to every single door in a street that you get to pick |
| 4.822 | 8.101 | I just found out today about something called USPS eddm |
Which TikTok data fields come back?
Live reads use one normalised shape for every video. Analysed videos add Virlo’s ranking and AI labels on top.
| Field group | Fields | Where |
|---|---|---|
| Video | id, url, caption, hashtags, published_at, duration_seconds, thumbnail_url | raw video, search, hashtag, creator videos |
| Engagement | views, likes, comments, shares, saves | all video endpoints |
| Creator | handle, display_name, verified, followers, following, likes, videos | raw creator, author object |
| Sound | sound id, title, artist; is_original and usage on analysed videos | video endpoints, /v1/sounds |
| Ranking | virality_score, median views and Virality Score of the whole result | POST /v1/search/videos |
| AI labels | hook_text, hook_type, visual_hook_type, content_format, visual_format, emotional_tone, brand_safety_tier | intelligence object on analysed videos |
| Transcript | text plus segments with start_seconds and end_seconds | raw transcript |
| TikTok extras | is_duet, is_stitch | platform_data |
Virality Score compares a video’s views with the size of the account that posted it, so a small account’s breakout ranks above a big account’s average post. The full list of AI fields is in the Data Intelligence docs.
How is Virlo’s TikTok API different from TikTok’s official API?
Virlo’s TikTok API is Virlo’s own API for public TikTok data. TikTok’s developer APIs serve different jobs, and each has its own access rules.
| Option | Built for | Who can use it |
|---|---|---|
| TikTok Research API | Public-data research | Approved academic and not-for-profit researchers in listed regions, independent of commercial interests |
| TikTok Display API | Showing a creator’s own profile and videos in your app | Apps whose users connect their own TikTok account (user.info.basic, video.list scopes) |
| Virlo TikTok API | Searching, ranking and reading public TikToks across creators | Any developer with a Virlo API key |
Sources: TikTok’s Research API eligibility page and Display API overview (developers.tiktok.com), read November 19, 2026. Pick TikTok’s own APIs when you need an account owner’s private data or an academic data grant; pick Virlo when you need public TikTok videos from many creators, ranked and labelled.
Should I use a TikTok API or a TikTok scraper?
Use an API when you want the data and not the upkeep. A home-made TikTok scraper means headless browsers, rotating proxies and new parsing code each time TikTok changes a page; Virlo’s TikTok API returns the same JSON fields on every call.
The analysed endpoints also give you what a scraper cannot: a Virality Score, hook and format labels, the formats creators are copying on Virlo’s TikTok trends page, the hook library behind viral hooks and sound rankings like trending TikTok sounds. Working in an AI app instead of code? The same TikTok data is on the TikTok MCP server, part of the Virlo MCP server. Researching Reels too? See the Instagram API page.
How this data was made
- Source
- Virlo’s database of social videos (23.1M+ TikTok and Instagram videos as of November 19, 2026; about 12.8M TikTok, Postgres planner estimate) and Virlo’s public API at api.virlo.ai.
- Window and sample
- One POST /v1/search/videos call on November 19, 2026: US TikToks about small business marketing, posted from November 5, 2026 to the day of the call, in English, ranked by Virality Score (282 matches; first page of 25 read).
- Method
- Endpoints and fields are taken from Virlo’s OpenAPI file and dev.virlo.ai docs. Example videos: the first results page minus AI-made, animated, paid and non-brand-safe videos, one per creator, top six by views; their counts were re-read live through GET /v1/raw/tiktok/video the same day. The transcript is one live GET /v1/raw/tiktok/video/transcript call.
- As of
- November 19, 2026. The sample is re-run when the page is updated.
- How this page is made
- Numbers and JSON come straight from the API responses; the text is written and checked by the Virlo team.
Source: Virlo, TikTok API for public video data, November 2026, virlo.ai/tiktok-api
Want the full list?
The sample above is one page of one search. To get the full response (every match, with hook text, formats and transcripts), create a free Virlo developer account at dev.virlo.ai/signup, copy your API key from the dashboard and send it as a Bearer token to api.virlo.ai/v1.
Frequently asked questions
Is there a TikTok API?
Yes. TikTok runs its own developer APIs (a Research API for approved researchers and a Display API for showing a creator’s own videos in your app), and Virlo runs a TikTok data API for public videos that any developer can call with an API key.
How do I get a TikTok API key?
For Virlo’s TikTok API, create a free developer account at dev.virlo.ai/signup and copy a key from the API Keys page of the dashboard. Send it as a Bearer token in the Authorization header. No TikTok login or app review is involved.
Can I use the TikTok API with Python?
Yes. It is a plain REST API over HTTPS that returns JSON, so the requests library is enough. The Python example on this page pulls a hashtag’s live videos and a ranked search in under 20 lines.
Can the TikTok API get video transcripts?
Yes. GET /v1/raw/tiktok/video/transcript returns the transcript TikTok publishes for a video as one text block and timed segments. The sample on this page returned 176 words in 19 segments for a 47-second video.
What is the difference between a TikTok API and a TikTok scraper?
With a scraper you run the browser, proxies and parsing yourself and fix them when TikTok changes its pages. With Virlo’s TikTok API you send a request and get the same normalised JSON fields every time; Virlo handles the collection.
Can I get TikTok hashtag data from an API?
Yes. /v1/raw/tiktok/hashtag/{hashtag} returns the live videos under a hashtag, and /v1/tiktok/hashtags ranks the top TikTok hashtags for any date range of up to 3 months by video count or total views.
Does the TikTok API return a Virality Score?
Videos from POST /v1/search/videos carry virality_score, Virlo’s single number for how far a video outran its creator’s audience. In the sample on this page the top TikTok scored 36.6 with 183.9K views from an account of 417 followers.
Can I find trending TikTok sounds and formats through the API?
Yes. /v1/sounds/trending?platform=tiktok ranks sounds by how many new videos use them, and /v1/content-trends?platform=tiktok lists the formats creators are copying, checked by Virlo’s team and refreshed every hour.
Do I need my own TikTok account to use the API?
No. Virlo’s TikTok API reads public TikTok data, so you never connect a TikTok account. It also cannot post, follow or comment for you.
Can AI agents use the TikTok API?
Yes. The same data is on Virlo’s MCP server, so Claude, Cursor or Codex can call the TikTok endpoints as tools. See the TikTok MCP server guide.
Pull TikTok data into your own code
Create a free developer account, copy your API key and make your first TikTok request in a couple of minutes.
Pay as you go. No TikTok login needed.