Live
Videos
Full engagement metrics for public videos. Returns play count, like count, comment count, share count, save count, caption, hashtags, media, music, and author details.
Refetcher returns real-time public TikTok data — video views, likes, comments, shares, saves and public creator metadata — as clean JSON from one endpoint. No TikTok login, cookies or tokens required.
Send any public TikTok video URL or creator profile URL — the API detects the target and returns the matching normalized JSON.
Full engagement metrics for public videos. Returns play count, like count, comment count, share count, save count, caption, hashtags, media, music, and author details.
TikTok profile responses can contain followers, total likes, video count, verification status, recent posts, views, likes, comments, shares, saves, pinned/ad flags, slideshow details, sound, media, and author data.
Authenticate with one header, POST a public TikTok video URL, and get the same predictable response shape every time — the identical pattern used for every platform we support.
# Scrape a public TikTok video
curl -s https://api.refetcher.com/ \
-H "X-API-Key: pc_live_••••" \
-d '{ "url": "https://www.tiktok.com/@creator/video/7398210000000000000", "includeRecentComments": true, "recentCommentsLimit": 3 }'
// → 200 OK
{
"platform": "tiktok",
"success": true,
"metrics": {
"views": 2400000,
"likes": 98400,
"comments": 3210,
"shares": 12200,
"saves": 18400
},
"post": {
"id": "7398210000000000000",
"normalizedUrl": "https://www.tiktok.com/@creator/video/7398210000000000000",
"publishedAt": "2026-06-01T08:30:00.000Z",
"caption": "Example video caption",
"type": "video",
"hashtags": [],
"mentions": [],
"region": "US"
},
"author": {
"id": "123456789",
"handle": "creator",
"name": "Creator Name",
"followers": 312000,
"following": 128,
"totalLikes": 9800000,
"videoCount": 420
},
"media": {
"type": "video",
"thumbnailUrl": "https://...",
"videoUrl": "https://...",
"durationSeconds": 18
},
"music": {
"title": "Original sound",
"authorName": "Creator Name"
},
"recentComments": [
{
"id": "comment-id",
"text": "Example public comment",
"likes": 12
}
]
}Batch up to 50 URLs in one request · Video endpoint docs · Profile endpoint docs
The normalized response shape for TikTok video scrapes. Fields that TikTok doesn't expose publicly for a given post are returned as null rather than omitted.
| Field | Type | Description |
|---|---|---|
| Metrics | ||
metrics.views | number | Play count at scrape time. |
metrics.likes | number | Public like count (diggCount). |
metrics.comments | number | Total comment count. |
metrics.shares | number | Total share count. |
metrics.saves | number | Save count (collectCount). |
| Post | ||
post.id | string | TikTok video ID from the URL. |
post.type | string | video or image. |
post.caption | string | Full description/caption text. |
post.hashtags | string[] | Hashtags extracted from the caption. |
post.mentions | string[] | Accounts mentioned in the caption. |
post.region | string · null | Public region value when TikTok includes it. |
post.language | string · null | Public language value when TikTok includes it. |
post.publishedAt | ISO 8601 | Original publish timestamp. |
post.isSponsored | boolean | Whether the video is marked as a paid partnership/sponsored. |
post.isPinned | boolean | Whether the video is pinned on the profile page. |
post.commentsDisabled | boolean | Whether comments are turned off. |
| Author | ||
author.id | string | TikTok unique ID for the creator. |
author.handle | string | Username/handle of the creator. |
author.name | string | Public display name. |
author.followers | number | Follower count at scrape time. |
author.following | number · null | Following count when exposed. |
author.totalLikes | number · null | Total public likes on the creator profile when exposed. |
author.videoCount | number · null | Public video count when exposed. |
author.bio | string · null | Creator bio/signature when exposed. |
author.isVerified | boolean | Whether the creator has a verified badge. |
author.profilePicUrl | string · null | Profile image URL when exposed. |
| Media and music | ||
media.type | string | video or image. |
media.thumbnailUrl | string · null | Thumbnail or cover URL. |
media.videoUrl | string · null | Public video source URL when included. |
media.durationSeconds | number · null | Video or sound duration in seconds when included. |
media.images | array | Image post URLs and dimensions when the post is an image carousel. |
music | object · null | Sound ID, title, author, duration, play URL, cover URL, and original-sound flag when included. |
| Comments | ||
recentComments | array | Embedded public comments when requested with includeRecentComments and present in the page payload. |
Power dashboards, bots and creator tools with live TikTok video metrics and public profile metadata — without maintaining proxies, headless browsers or session pools yourself.
Verify influencer video performance with real numbers instead of screenshots. Track campaign video performance across every creator from one endpoint.
Batch up to 50 creator URLs per request and ingest normalized engagement data into warehouses, models and trend analysis pipelines.
For public videos: views, likes, comments, shares, saves, caption, hashtags, mentions, publish date, author details, media, music, and optional embedded comments. Creator profile responses can contain public profile counts, recent posts, post engagement, pinned and ad flags, slideshow metadata, sound, media, and repeated author details.
No. You authenticate with a Refetcher API key only. The API retrieves publicly available TikTok data, so no TikTok login, session cookie or token is required.
Yes. Send a public TikTok video URL and the API returns its play count, likes, comments, shares, saves and related engagement metrics in a clean normalized JSON shape.
Yes. Send a public creator profile URL or username. TikTok profile responses can contain followers, total likes, video count, verification status, recent posts, per-post engagement, metadata, sound, media, and author fields when publicly available.
TikTok video scraping and public creator profile scraping are live. Profile responses can contain public creator data plus available per-post engagement, metadata, sound, media, and author fields. TikTok does not expose a trustworthy actual repost counter in these logged-out sources, so reposts is null rather than a false zero.
Pricing is pay as you go at $0.90 per 1,000 successful scrapes with no subscription or monthly minimum. Failed scrapes are free, credits never expire, and new accounts get $10 of free credit without a card. Full details on the pricing page.
The scrape fails and you are not charged for it. Refetcher only deducts balance for successful scrape results.
Data is retrieved at request time, so the metrics reflect what is publicly visible on TikTok when you make the call. Current latency and success rates are published on the public status page.
$10 of free TikTok scraping, no card required. See real numbers before you commit to anything.
Get your API key →