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
TikTok

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

TikTok endpoints in Virlo’s API (base URL https://api.virlo.ai)
MethodPathWhat 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}/videosA creator’s recent TikToks, newest first
POST/v1/search/videosSearch analysed TikToks by topic, look, date, region, views or Virality Score
GET/v1/tiktok/hashtagsTop TikTok hashtags for a date range (up to 3 months), by video count or views
GET/v1/tiktok/videos/digestThe most-viewed TikToks published in the last 24 to 48 hours
GET/v1/content-trends?platform=tiktokFormats TikTok creators are copying now, with a recipe, lifecycle stage and example videos
GET/v1/sounds/trending?platform=tiktokSounds used in the most new TikToks over 7 or 30 days
GET/v1/hooks/search?platform=tiktokOpening 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.

  1. Create a free Virlo developer account.
  2. Copy an API key (it starts with virlo_tkn_) from the API Keys page.
  3. Call any TikTok endpoint from the table above with that key as a Bearer token.
curl: videos under a TikTok hashtag
curl -G "https://api.virlo.ai/v1/raw/tiktok/hashtag/smallbusiness" \
  -H "Authorization: Bearer $VIRLO_API_KEY"
Python (requests): hashtag page + ranked search
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"])
JavaScript (Node 18+ fetch): TikTok transcript
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.

Top real TikToks in the response (views, likes and saves re-checked November 19, 2026)
CreatorPostedViewsLikesSavesVirality ScoreHook typeFormat
@gretasgames2026-11-12183,90012,8008,32036.6bold claimexplainer
@bymacykaye2026-11-1323,3002,5061,5765.5not labelledexplainer
@growthbygigi2026-11-126,864394775.3not labelledother
@clipminddaily12026-11-142,16882285.5not labelledexplainer
@philfixesgrowth2026-11-092,051166325bold claimexplainer
@pope_musicofficial2026-11-101,11872485.9direct addressexplainer

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:

POST /v1/search/videos response (excerpt)as of November 19, 2026
{
  "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 all

The 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.

First three transcript segments returned for the top TikTok
Start (s)End (s)Text
02.02the post office will deliver your flyers
2.0214.821to every single door in a street that you get to pick
4.8228.101I 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.

TikTok fields by endpoint family
Field groupFieldsWhere
Videoid, url, caption, hashtags, published_at, duration_seconds, thumbnail_urlraw video, search, hashtag, creator videos
Engagementviews, likes, comments, shares, savesall video endpoints
Creatorhandle, display_name, verified, followers, following, likes, videosraw creator, author object
Soundsound id, title, artist; is_original and usage on analysed videosvideo endpoints, /v1/sounds
Rankingvirality_score, median views and Virality Score of the whole resultPOST /v1/search/videos
AI labelshook_text, hook_type, visual_hook_type, content_format, visual_format, emotional_tone, brand_safety_tierintelligence object on analysed videos
Transcripttext plus segments with start_seconds and end_secondsraw transcript
TikTok extrasis_duet, is_stitchplatform_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.

TikTok data access options compared
OptionBuilt forWho can use it
TikTok Research APIPublic-data researchApproved academic and not-for-profit researchers in listed regions, independent of commercial interests
TikTok Display APIShowing a creator’s own profile and videos in your appApps whose users connect their own TikTok account (user.info.basic, video.list scopes)
Virlo TikTok APISearching, ranking and reading public TikToks across creatorsAny 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.