ScrapeUnblocker Documentation

The TikTok plugin reads public TikTok data as structured JSON through five endpoints: a creator profile with its newest videos, a single video or photo post, a hashtag with its totals and videos, a keyword search, and the comments of a post. TikTok renders nothing useful into the DOM - the page ships its state as one JSON blob - so the plugin reads that blob directly: no browser, no rendering wait, about two seconds a page. TikTok publishes every count twice, rounded for display (1.6M) and exact underneath (1593675); you get the exact one. Video lists are not in the HTML (TikTok loads its grids through signed requests), so the plugin reads TikTok’s server-rendered embed widgets for the newest / top ten, and opens the real page in a browser session when you ask for more (up to 200), or when TikTok does not serve a hashtag through the widget. Every listed video carries the full video shape below. Keyword search and comments run in a browser session too: TikTok guards both behind its rotate-the-picture captcha, which the session solves on the fly, so they take 20-45 seconds a call.

Try it in the dashboard first: app.scrapeunblocker.com/dashboard/plugins/tiktok. You get a live preview plus a copy-paste snippet.

Only public data is read - no TikTok account, cookies or login. Private, deleted, banned or region-locked items answer 404 with TikTok’s own reason. Media URLs (playUrl, downloadUrl, covers, music) are signed by TikTok and expire after a few hours, so download what you need in the same run.

Creator profile

Exact stats, bio, link, flags and the creator’s newest videos.

POST /social/tiktok-profile

Field	Required	Default	Notes
`username`	yes	-	Handle (`nasa`, `@nasa`) or a profile URL.
`max_videos`	no	`10`	Newest videos to include, `0`-`200`. `0` = profile only (fastest). Up to `10` come from TikTok’s widget in a couple of seconds; more opens the profile in a browser session and scrolls the real grid (about 35 a batch, 10-30 s).
`video_details`	no	`true`	Read each widget-listed video’s own page for exact engagement, hashtags, music, media URLs and timestamps. `false` = only id, caption, cover and play count.
`proxy_country`	no	-	Exit-IP country (ISO-2). TikTok’s public pages are the same worldwide; set it only for region-restricted items.

cURL

curl -X POST "https://api.scrapeunblocker.com/social/tiktok-profile?username=nasa&max_videos=5" \
  -H "x-scrapeunblocker-key: YOUR_API_KEY"

Response

{
  "username": "nasa",
  "userId": "7664638705177150477",
  "secUid": "MS4wLjABAAAAU9BRVzC8oCaegVnia8Ibq...",
  "nickname": "NASA",
  "bio": "Making the seemingly impossible, possible.",
  "bioLink": null,
  "verified": true,
  "privateAccount": false,
  "isOrganization": true,
  "language": "en",
  "createdAt": "2026-07-20T15:55:49+00:00",
  "avatar": { "thumb": "https://...", "medium": "https://...", "large": "https://..." },
  "stats": { "followers": 1593675, "following": 23, "likes": 8063306, "videos": 41, "friends": 17, "diggs": 0 },
  "commerce": { "commerceUser": false, "seller": false },
  "settings": { "comments": 0, "duet": 0, "stitch": 0, "download": 0, "followingVisible": 1 },
  "profileUrl": "https://www.tiktok.com/@nasa",
  "videos": [ { "...": "full video objects, see below" } ],
  "videosCollected": 5,
  "videosSource": "embed",
  "hasMore": null
}

videosSource is embed (widget, newest ten) or browser (real grid); hasMore is set on the browser path when the grid had more than you asked for.

Video or photo post

One post with exact engagement, media, music and captions.

POST /social/tiktok-video

Field	Required	Default	Notes
`url`	yes	-	A video URL (`https://www.tiktok.com/@nasa/video/7665075736742530317`), a photo-post URL (`/photo/`), a bare video id, or a `vm.tiktok.com` / `tiktok.com/t/` short link.
`include_transcript`	no	`false`	Also download the subtitle track (TikTok’s own captions, mostly auto-generated) and return it as plain text in `transcript`, one line per cue. Adds about a second.
`transcript_language`	no	first track	Preferred subtitle language when several exist (`eng-US`, `spa-ES`, or just `eng`).
`proxy_country`	no	-	Exit-IP country (ISO-2).

cURL

curl -X POST "https://api.scrapeunblocker.com/social/tiktok-video?url=https%3A%2F%2Fwww.tiktok.com%2F%40nasa%2Fvideo%2F7665075736742530317&include_transcript=true" \
  -H "x-scrapeunblocker-key: YOUR_API_KEY"

Response

{
  "id": "7665075736742530317",
  "url": "https://www.tiktok.com/@nasa/video/7665075736742530317",
  "type": "video",
  "description": "Something big just landed on TikTok.",
  "title": null,
  "hashtags": [],
  "mentions": [],
  "language": "en",
  "createdAt": "2026-07-21T20:09:02+00:00",
  "createdTimestamp": 1784664542,
  "stats": { "plays": 1200000, "likes": 84400, "comments": 2528, "shares": 2944, "saves": 6302, "reposts": 0 },
  "author": {
    "username": "nasa", "nickname": "NASA", "userId": "7664638705177150477", "secUid": "...",
    "verified": true, "privateAccount": false, "bio": "...", "avatar": "https://...",
    "profileUrl": "https://www.tiktok.com/@nasa",
    "stats": { "followers": 1593675, "following": 23, "likes": 8063306, "videos": 41 }
  },
  "video": {
    "duration": 25, "width": 720, "height": 1280, "ratio": "720p", "format": "mp4", "codec": "h264",
    "bitrate": 1066942, "size": 3356735,
    "cover": "https://...", "originCover": "https://...", "dynamicCover": "https://...",
    "playUrl": "https://...", "downloadUrl": "https://...",
    "qualities": [ { "name": "normal_720_0", "quality": "normal", "bitrate": 1066942, "codec": "h264", "width": 720, "height": 1280, "size": 3356735, "url": "https://..." } ],
    "subtitles": [ { "language": "eng-US", "format": "webvtt", "source": "ASR", "url": "https://...", "expiresAt": "..." } ],
    "hasOriginalAudio": true
  },
  "images": null,
  "imageCount": null,
  "music": { "id": "7665075815390645006", "title": "original sound", "author": "NASA", "album": null, "original": true, "duration": 25, "playUrl": "https://...", "cover": "https://...", "copyrighted": false },
  "flags": { "isAd": false, "isAigc": false, "private": false, "duetEnabled": true, "stitchEnabled": true, "shareEnabled": true, "commentsEnabled": true, "originalItem": false, "scheduled": false },
  "labels": ["Space", "Science & Education", "Aerospace & Astronomy"],
  "suggestedWords": [],
  "effects": [],
  "stickerTexts": [],
  "locationCreated": "US",
  "aigcDescription": null,
  "transcript": "We're going back to the Moon...",
  "transcriptLanguage": "eng-US",
  "detailed": true
}

Photo posts come back with type: "photo", a title, images (URL, width, height per image) and imageCount; video is null for them.

Hashtag

Total views and videos under a tag, plus its videos.

POST /social/tiktok-hashtag

Field	Required	Default	Notes
`hashtag`	yes	-	Name (`nasa`, `#nasa`) or a tag URL (`https://www.tiktok.com/tag/nasa`).
`max_videos`	no	`10`	Videos to include, `0`-`200`. `0` = totals only. Up to `10` top videos come from TikTok’s widget; more scrolls the real grid in a browser session. Hashtags TikTok does not serve through the widget (for example `#comedy`, `#gaming`) are read from the grid too.
`video_details`	no	`true`	As for the profile.
`proxy_country`	no	-	Exit-IP country (ISO-2).

cURL

curl -X POST "https://api.scrapeunblocker.com/social/tiktok-hashtag?hashtag=nasa&max_videos=5" \
  -H "x-scrapeunblocker-key: YOUR_API_KEY"

Response

{
  "hashtag": "nasa",
  "id": "3301",
  "title": null,
  "cover": null,
  "url": "https://www.tiktok.com/tag/nasa",
  "stats": { "views": 56442252172, "videos": 1916718 },
  "videos": [ { "...": "full video objects" } ],
  "videosCollected": 5,
  "videosSource": "embed",
  "hasMore": null
}

Keyword search

The videos TikTok ranks for a query, region selectable.

POST /social/tiktok-search

Field	Required	Default	Notes
`query`	yes	-	Search keywords, e.g. `space telescope`.
`max_results`	no	`20`	Videos to return, `1`-`200` (about 12 arrive per scroll).
`proxy_country`	no	-	Exit-IP country (ISO-2). TikTok ranks search by region, so set it to get what a user in that country sees.

cURL

curl -X POST "https://api.scrapeunblocker.com/social/tiktok-search?query=space%20telescope&max_results=25" \
  -H "x-scrapeunblocker-key: YOUR_API_KEY"

Response

{
  "query": "space telescope",
  "url": "https://www.tiktok.com/search/video?q=space%20telescope",
  "results": [ { "...": "full video objects, in TikTok's ranking" } ],
  "resultsCollected": 25,
  "hasMore": true
}

Comments

The comments of a post, with author, likes, creator flags and preloaded replies.

POST /social/tiktok-comments

Field	Required	Default	Notes
`url`	yes	-	Video / photo-post URL, bare id or short link (same forms as the video endpoint).
`max_comments`	no	`50`	Top-level comments to return, `1`-`500` (20 arrive per scroll).
`proxy_country`	no	-	Exit-IP country (ISO-2).

cURL

curl -X POST "https://api.scrapeunblocker.com/social/tiktok-comments?url=https%3A%2F%2Fwww.tiktok.com%2F%40nasa%2Fvideo%2F7665075736742530317&max_comments=40" \
  -H "x-scrapeunblocker-key: YOUR_API_KEY"

Response

{
  "videoId": "7665075736742530317",
  "url": "https://www.tiktok.com/@nasa/video/7665075736742530317",
  "totalComments": 2532,
  "comments": [
    {
      "id": "7665263325262201622",
      "text": "Howdy partners!",
      "createdAt": "2026-07-22T08:17:14+00:00",
      "createdTimestamp": 1784708234,
      "likes": 7101,
      "replyCount": 67,
      "language": "en",
      "author": { "username": "europeanspaceagency", "nickname": "ESA", "userId": "7374008994362803233", "secUid": "...", "avatar": "https://...", "profileUrl": "https://www.tiktok.com/@europeanspaceagency" },
      "isCreator": false,
      "likedByCreator": true,
      "replyToCommentId": null,
      "replies": [],
      "videoId": "7665075736742530317"
    }
  ],
  "commentsCollected": 40,
  "hasMore": true
}

Errors

Status	Meaning
`400`	Missing or malformed `username` / `url` / `hashtag`, or a bad `proxy_country`.
`404`	The profile does not exist, was banned or is private; the post was deleted, is private or region-locked; the hashtag has no page; a search or a post has no results / comments. The message carries TikTok’s status code where TikTok gave one.
`502`	TikTok blocked every exit, a browser grid did not arrive in time, or the captcha could not be solved - retry, or try another `proxy_country`.
`504`	The fetch timed out.

What you can build

Influencer discovery and vetting - exact follower counts, engagement per video and posting cadence across a list of handles.
Campaign and hashtag tracking - total views and videos under a tag over time, and which creators and sounds are winning it right now.
Engagement monitoring - plays, likes, comments, shares and saves for your own or a competitor’s posts, on a schedule.
Content and trend analysis - captions, hashtags, sounds, topic labels and transcripts for research, dashboards or LLM pipelines.

Next steps

Plugins overview - every dedicated endpoint.
Threads plugin - the same idea for Meta’s Threads.
Page source - fetch any other TikTok page yourself; parsed_data=true returns the profile / video counts as JSON too.

Get Started

No-code area

Spider Cloud

Plugins

AI Assistants

Guides

Code Examples

TikTok plugin

Creator profile

Response

Video or photo post

Response

Hashtag

Response

Keyword search

Response

Comments

Response

Errors

What you can build

Next steps

​Creator profile

​Response

​Video or photo post

​Response

​Hashtag

​Response

​Keyword search

​Response

​Comments

​Response

​Errors

​What you can build

​Next steps

Creator profile

Response

Video or photo post

Response

Hashtag

Response

Keyword search

Response

Comments

Response

Errors

What you can build

Next steps