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.
Public profile metadata and creator metrics — track followers, total likes, video count, verification status, and recent public videos. Request more pages to page deeper through a creator's posts — each page returns up to 12 posts and counts as one successful scrape, at the same $0.90 per 1,000 price.
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. For creator profiles: public follower count, total likes, video count, verification status and the recent videos TikTok exposes without login.
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 and the API returns public profile counts such as followers along with links-only recent videos. Set pages to request more profile pages, up to 12 post references per page.
TikTok video scraping and public creator profile scraping are live. Profile requests return public creator metadata and links-only recent videos, and multi-page profile pagination can page past the first batch of posts.
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 →