Skip to main content

​
TikTok Scraper API

Fetch full user profiles, posted videos, comments and replies, video transcripts, hashtag and music detail, run keyword search across videos/users/hashtags, pull trending videos/hashtags/songs, and query TikTok’s EU Commercial Content (ad transparency) library. The API handles request signing, anti-bot bypass, and regional proxy routing automatically.

​
Key Features

Profiles & Videos

Full user profiles with stats and verification, plus posted videos and reposts with cursor pagination.

Comments & Transcripts

Top-level comments, threaded replies, and ASR voice-to-text transcripts with subtitle tracks.

Search

Keyword search across videos, users, and hashtags, plus a general Top-feed search.

Trending

Trending videos, hashtags, and songs ranked by usage, with rank-change deltas.

Ad Transparency

Search TikTok’s EU Commercial Content Library by keyword or advertiser id.

SDK Support

First-class support via the ScrapeBadger Node.js and Python SDKs.

​
Supported Regions

TikTok content is region-aware. Use the region query parameter (ISO 3166-1 alpha-2) on any endpoint to route the request through a proxy and signer for that locale. It defaults to US.
Use the /v1/tiktok/regions endpoint to get the full list of supported regions (with locale and country code) programmatically.

​
Quick Start

import ScrapeBadger from "scrapebadger";

const client = new ScrapeBadger({ apiKey: "YOUR_API_KEY" });

const profile = await client.tiktok.getUser({
  username: "charlidamelio",
  region: "US",
});

console.log(profile.user.stats.follower_count);

​
Endpoints

EndpointMethodDescription
/v1/tiktok/users/{username}GETFull user profile by @handle
/v1/tiktok/users/{username}/videosGETA user’s posted videos
/v1/tiktok/users/{username}/repostsGETVideos a user has reposted
/v1/tiktok/videos/{video_id}GETFull metadata for a single video
/v1/tiktok/videos/{video_id}/commentsGETTop-level comments on a video
/v1/tiktok/videos/{video_id}/relatedGETRelated/recommended videos
/v1/tiktok/videos/{video_id}/transcriptGETSubtitle tracks + voice-to-text
/v1/tiktok/comments/{comment_id}/repliesGETReplies to a comment
/v1/tiktok/oembedGETCheap unauthenticated oEmbed metadata
/v1/tiktok/hashtags/{name}GETHashtag/challenge detail
/v1/tiktok/hashtags/{name}/videosGETVideos tagged with a hashtag
/v1/tiktok/music/{music_id}GETSound/music detail
/v1/tiktok/music/{music_id}/videosGETVideos using a sound
/v1/tiktok/searchGETGeneral Top-feed search
/v1/tiktok/search/usersGETSearch users by keyword
/v1/tiktok/search/videosGETSearch videos by keyword
/v1/tiktok/search/hashtagsGETSearch hashtags by keyword
/v1/tiktok/trending/videosGETTrending Explore-feed videos
/v1/tiktok/trending/hashtagsGETTrending hashtags by usage
/v1/tiktok/trending/songsGETTrending songs/sounds by usage
/v1/tiktok/ads/searchGETSearch the EU ad library
/v1/tiktok/regionsGETList supported regions

​
Credit Costs

EndpointCost
Get user profile5 credits
Get user videos8 credits
Get user reposts8 credits
Get video detail5 credits
Get comments8 credits
Get related videos8 credits
Get transcript10 credits
Get comment replies8 credits
oEmbed2 credits
Get hashtag detail5 credits
Get hashtag videos8 credits
Get music detail5 credits
Get music videos8 credits
Search (general)5 credits
Search users5 credits
Search videos5 credits
Search hashtags5 credits
Trending videos5 credits
Trending hashtags5 credits
Trending songs5 credits
Ad library search5 credits
List regions0 credits
Failed requests0 credits

​
Authentication

All requests require your API key in the x-api-key header: 
curl "https://scrapebadger.com/v1/tiktok/users/charlidamelio" \
  -H "x-api-key: YOUR_API_KEY"

​
Anti-Bot Handling & Notes

TikTok protects its mobile and web APIs with request signing (X-Argus / X-Ladon / X-Gorgon / X-Khronos), device trust, and per-IP reputation scoring. ScrapeBadger clears these automatically — you never need to manage signatures, device registration, proxies, or sessions. Requests are routed through proxies matched to the region you request.
Trending hashtags and trending songs (/v1/tiktok/trending/hashtags, /v1/tiktok/trending/songs) are served via an on-device signer path. They are ranked by real usage (view counts, distinct-creator counts) rather than the deprecated Creative Center trend lists.
Followers, following, and liked-video lists are deprecated. These endpoints (/v1/tiktok/users/{username}/followers, /following, /liked) require an authenticated account session, which this API intentionally does not provide. They return HTTP 410 Gone with a deprecation notice and are not charged. All other TikTok endpoints (videos, profile, search, comments, hashtags, trending, music) remain fully supported.

​
Next Steps

Get User Profile

Full API reference for fetching a TikTok user profile

Get Video Detail

Retrieve full metadata for a specific TikTok video