# TikTok Scraper API

> TikTok operations behind one key: profiles, video metadata, comments and replies, comment-thread user discovery and account-health checks — no login.

These operations cover TikTok profiles, videos and comment threads without a TikTok login. Get User Profile reads a full public profile — bio, follower/following/like counts, verified status and video count — server-side, via TikTok’s own server-rendered page rather than its app API. Get Video Detail and Get Video By Id both return full video metadata (description, stats, author, music, hashtags); the difference is what you start from — Get Video Detail takes an author handle plus a video reference, while Get Video By Id resolves a video from its id alone. TikTok oEmbed Lookup is the lightest: it resolves any profile or video URL to a title, author and thumbnail through TikTok’s own public oEmbed endpoint, with no signing. Get Comments and Get Comment Replies read a video’s comment thread and the replies under one comment, both cursor-paginated. Discover Users from Comments mines the unique commenters off a video into a list of profiles — a comment thread as a lead list. Check Account Health reports whether an account is active, private or suspended, alongside its follower, video and like counts. All of them authenticate with your upAPI key alone. Reads run under a Safari TLS fingerprint, which is documented internally as the one that reaches TikTok’s pages where a default Chrome client fingerprint is blocked outright; TikTok’s WAF answers a block with a normal HTTP 200 carrying an empty page rather than an error status, and these operations classify that empty-page case rather than returning it as if it were real data.

## Operations

- [TikTok Get User Profile](https://upapi.io/apis/social-media/tiktok-get-user-profile) (15 units): Get full user profile (bio, stats, verified status) via SSR scraping. No auth needed.
- [TikTok Get Video Detail](https://upapi.io/apis/social-media/tiktok-get-video-detail) (15 units): Get full video metadata (description, stats, author, music) via SSR scraping. No auth needed.
- [TikTok Get Video By Id](https://upapi.io/apis/social-media/tiktok-get-video-embed) (3 units): Full video metadata (description, hashtags, play/like/comment counts, author and author follower stats) from a video id alone — no author handle needed, no auth.
- [TikTok oEmbed Lookup](https://upapi.io/apis/social-media/tiktok-oembed) (1 unit): Resolve any TikTok profile or video URL to its title, author and thumbnail via TikTok's public oEmbed endpoint. No auth, no signing.
- [TikTok Get Comments](https://upapi.io/apis/social-media/tiktok-get-comments) (15 units): Get comments on a video with commenter info. No auth needed. Supports pagination via cursor.
- [TikTok Get Comment Replies](https://upapi.io/apis/social-media/tiktok-get-comment-replies) (3 units): Get the replies under a single TikTok comment, with each replier's handle and profile info. No auth needed. Paginated by cursor.
- [TikTok Discover Users from Comments](https://upapi.io/apis/social-media/tiktok-discover-users) (15 units): Mine unique commenters from a video for lead discovery. No auth needed. Returns user profiles from comment threads.
- [TikTok Check Account Health](https://upapi.io/apis/social-media/tiktok-check-account-health) (15 units): Check if TikTok account is active/suspended. Returns follower, video, and like counts.

## Frequently asked questions

### Do I need a TikTok account or login?

No. Every operation here reads TikTok’s public surface — server-rendered pages, the public oEmbed endpoint, and public comment threads — and authenticates only with your upAPI key.

### What is the difference between Get Video Detail and Get Video By Id?

Get Video Detail needs an author handle alongside the video reference; Get Video By Id resolves the same full metadata (description, hashtags, play/like/comment counts, author stats) from the video id alone, with no author handle required.

### How much does this cost?

TikTok Get User Profile is 15 units per call; TikTok Get Video Detail is 15 units per call; TikTok Get Video By Id is 3 units per call; TikTok oEmbed Lookup is 1 unit per call; TikTok Get Comments is 15 units per call; TikTok Get Comment Replies is 3 units per call; TikTok Discover Users from Comments is 15 units per call; TikTok Check Account Health is 15 units per call — every unit draws from one pooled monthly quota shared across the whole catalog. See upapi.io/pricing for what a unit costs on each plan.

### How does this handle TikTok blocking the request?

TikTok’s WAF answers a blocked request with HTTP 200 and an empty page rather than an error code, so a naive integration would read a block as an empty result. These operations detect the missing rehydration payload and raise a classified error instead.

### Can I turn a video’s commenters into a lead list?

Discover Users from Comments does exactly that — it mines the unique commenters off one video and returns their profiles in a single call, scanning until it has enough distinct users or runs out of comments.

### How fresh is the data — is it cached?

TikTok Get User Profile is cached for 10 minutes; TikTok Get Video Detail is cached for 5 minutes; TikTok Get Video By Id is cached for 10 minutes; TikTok oEmbed Lookup is cached for 1 hour; TikTok Get Comments is cached for 2 minutes; TikTok Get Comment Replies is cached for 2 minutes; TikTok Discover Users from Comments is cached for 5 minutes; TikTok Check Account Health is cached for 1 minute. A repeat call inside a cached window returns the cached response and is billed nothing.

Last updated 2026-10-20.
