TikTok API

23 endpoints for public TikTok data, from 1 credit a call. Same response format and field names as every other platform.

curl "https://scrapeio.com/v1/tiktok/profile?handle=nike" \
  -H "x-api-key: YOUR_KEY"

For agents/platforms/tiktok.md/skill.mdMCP: 23 tools

GET/v1/tiktok/profile1 credit

TikTok profile: bio, avatar, followers, following, likes, video count.

Parameter	Type	Description
`handle`required	string	TikTok username, with or without @.

curl "https://scrapeio.com/v1/tiktok/profile?handle=nike" \
  -H "x-api-key: YOUR_KEY"

GET/v3/tiktok/profile/videos1 credit

A profile's videos, newest first, with plays, likes, comments, shares and saves.

Parameter	Type	Description
`handle`required	string	TikTok username, with or without @.
`cursor`	string	Cursor from the previous page's data.cursor.

curl "https://scrapeio.com/v3/tiktok/profile/videos?handle=nike" \
  -H "x-api-key: YOUR_KEY"

GET/v2/tiktok/video5 credits

One TikTok video by URL: stats, caption, author, music, download URL.

Parameter	Type	Description
`url`required	string	TikTok video URL.

curl "https://scrapeio.com/v2/tiktok/video?url=..." \
  -H "x-api-key: YOUR_KEY"

GET/v1/tiktok/video/transcript5 credits

Spoken-word transcript of a TikTok video, from its captions.

Parameter	Type	Description
`url`required	string	TikTok video URL.
`language`	string	Preferred language code, e.g. en.

curl "https://scrapeio.com/v1/tiktok/video/transcript?url=..." \
  -H "x-api-key: YOUR_KEY"

GET/v1/tiktok/video/comments1 credit

Comments on a TikTok video, most liked first.

Parameter	Type	Description
`url`required	string	TikTok video URL.
`cursor`	string	Cursor from the previous page's data.cursor.

curl "https://scrapeio.com/v1/tiktok/video/comments?url=..." \
  -H "x-api-key: YOUR_KEY"

GET/v1/tiktok/video/comment/replies1 credit

Replies to one TikTok comment.

Parameter	Type	Description
`url`required	string	TikTok video URL.
`comment_id`required	string	Comment id from the comments endpoint.
`cursor`	string	Cursor from the previous page's data.cursor.

curl "https://scrapeio.com/v1/tiktok/video/comment/replies?url=...&comment_id=..." \
  -H "x-api-key: YOUR_KEY"

GET/v1/tiktok/search/keyword5 credits

Search TikTok videos by keyword.

Parameter	Type	Description
`query`required	string	Search text.
`sort_by`	relevance, most-liked, latest	Sort order.
`date_posted`	all, yesterday, this-week, this-month, last-3-months, last-6-months	Posted within.
`cursor`	string	Cursor from the previous page's data.cursor.

curl "https://scrapeio.com/v1/tiktok/search/keyword?query=coffee" \
  -H "x-api-key: YOUR_KEY"

GET/v1/tiktok/search/users5 credits

Search TikTok accounts by keyword.

Parameter	Type	Description
`query`required	string	Search text.
`cursor`	string	Cursor from the previous page's data.cursor.

curl "https://scrapeio.com/v1/tiktok/search/users?query=coffee" \
  -H "x-api-key: YOUR_KEY"

GET/v1/tiktok/search/hashtag5 credits

Videos under a hashtag, plus the hashtag's totals.

Parameter	Type	Description
`hashtag`required	string	Hashtag, with or without #.
`cursor`	string	Cursor from the previous page's data.cursor.

curl "https://scrapeio.com/v1/tiktok/search/hashtag?hashtag=travel" \
  -H "x-api-key: YOUR_KEY"

GET/v1/tiktok/trending5 credits

Trending feed for a region.

Parameter	Type	Description
`region`	string	Two-letter country code. Default: US.

curl "https://scrapeio.com/v1/tiktok/trending" \
  -H "x-api-key: YOUR_KEY"

GET/v1/tiktok/user/followers5 credits

A profile's followers, newest first.

Parameter	Type	Description
`handle`required	string	TikTok username, with or without @.
`cursor`	string	Cursor from the previous page's data.cursor.

curl "https://scrapeio.com/v1/tiktok/user/followers?handle=nike" \
  -H "x-api-key: YOUR_KEY"

GET/v1/tiktok/user/liked1 credit

Videos a profile has liked (when public).

Parameter	Type	Description
`handle`required	string	TikTok username, with or without @.
`cursor`	string	Cursor from the previous page's data.cursor.

curl "https://scrapeio.com/v1/tiktok/user/liked?handle=nike" \
  -H "x-api-key: YOUR_KEY"

GET/v1/tiktok/song5 credits

A TikTok sound: title, author, duration, usage count.

Parameter	Type	Description
`url`required	string	TikTok sound or video URL.

curl "https://scrapeio.com/v1/tiktok/song?url=..." \
  -H "x-api-key: YOUR_KEY"

GET/v1/tiktok/song/videos5 credits

Videos that use a sound.

Parameter	Type	Description
`music_id`required	string	Sound id from the song endpoint.
`cursor`	string	Cursor from the previous page's data.cursor.

curl "https://scrapeio.com/v1/tiktok/song/videos?music_id=..." \
  -H "x-api-key: YOUR_KEY"

GET/v1/tiktok/collection/videos5 credits

Collection Videos

Parameter	Type	Description
`url`required	string	Public TikTok collection URL
`cursor`	string	Cursor to get more videos.

curl "https://scrapeio.com/v1/tiktok/collection/videos?url=..." \
  -H "x-api-key: YOUR_KEY"

GET/v1/tiktok/get-trending-feed5 credits

Trending Feed

Parameter	Type	Description
`region`required	string	Where you want the proxy to be.
`trim`	boolean	Set to true to get a trimmed response.

curl "https://scrapeio.com/v1/tiktok/get-trending-feed?region=US" \
  -H "x-api-key: YOUR_KEY"

GET/v1/tiktok/live5 credits

Live Info

Parameter	Type	Description
`room_id`required	string	TikTok live room id.
`user_id`required	string	TikTok numeric user id for the live owner.

curl "https://scrapeio.com/v1/tiktok/live?room_id=...&user_id=..." \
  -H "x-api-key: YOUR_KEY"

GET/v1/tiktok/profile/region5 credits

Profile Region

Parameter	Type	Description
`handle`required	string	TikTok handle

curl "https://scrapeio.com/v1/tiktok/profile/region?handle=nike" \
  -H "x-api-key: YOUR_KEY"

GET/v1/tiktok/search/suggestions5 credits

Search Suggestions

Parameter	Type	Description
`query`required	string	Search query to get suggestions for
`region`	string	Region code for suggestions

curl "https://scrapeio.com/v1/tiktok/search/suggestions?query=coffee" \
  -H "x-api-key: YOUR_KEY"

GET/v1/tiktok/search/top5 credits

Top Search

Parameter	Type	Description
`query`required	string	Keyword to search for
`publish_time`	yesterday, this-week, this-month, last-3-months, last-6-months, all-time	Time Frame TikTok was posted
`sort_by`	relevance, most-liked, date-posted	Sort by
`region`	string	Note, this doesn't filter the tiktoks only in a specfic region, it puts the proxy there.
`cursor`	string	Cursor to get more videos.

curl "https://scrapeio.com/v1/tiktok/search/top?query=coffee" \
  -H "x-api-key: YOUR_KEY"

GET/v1/tiktok/user/audienceup to 130 credits

User's Audience Demographics

Parameter	Type	Description
`handle`required	string	TikTok handle

curl "https://scrapeio.com/v1/tiktok/user/audience?handle=nike" \
  -H "x-api-key: YOUR_KEY"

GET/v1/tiktok/user/following5 credits

Following

Parameter	Type	Description
`handle`required	string	TikTok handle
`trim`	boolean	Set to true to get a trimmed response
`min_time`	string	Used to paginate.

curl "https://scrapeio.com/v1/tiktok/user/following?handle=nike" \
  -H "x-api-key: YOUR_KEY"

GET/v1/tiktok/user/live5 credits

Live

Parameter	Type	Description
`handle`required	string	TikTok handle

curl "https://scrapeio.com/v1/tiktok/user/live?handle=nike" \
  -H "x-api-key: YOUR_KEY"

TikTok API

Other platforms