This endpoint errs towards returning more rather than less, so expect a few extra rows alongside what you asked for. Everything still comes back typed and parsed the same way.
POST
/api/public/v1/scrape/tiktok/posts
A creator's video feed. Use `limit` to say how many you want.
Returns video_feed_api
Parameters
Name
Required
Description
Example
username
required
Handle, with or without the @.
nasa
Takes limit — how many results you want. The run is sized from it, and you are billed for exactly that many.
This endpoint errs towards returning more rather than less, so expect a few extra rows alongside what you asked for. Everything still comes back typed and parsed the same way.
POST
/api/public/v1/scrape/tiktok/liked
Videos a creator has liked. Use `limit` to say how many you want.
Returns video_feed_api
Parameters
Name
Required
Description
Example
username
required
Handle, with or without the @. The account's liked list must be public.
nasa
Takes limit — how many results you want. The run is sized from it, and you are billed for exactly that many.
This endpoint errs towards returning more rather than less, so expect a few extra rows alongside what you asked for. Everything still comes back typed and parsed the same way.
POST
/api/public/v1/scrape/tiktok/reposts
Videos a creator has reposted. Use `limit` to say how many you want.
Returns video_feed_api
Parameters
Name
Required
Description
Example
username
required
Handle, with or without the @.
nasa
Takes limit — how many results you want. The run is sized from it, and you are billed for exactly that many.
This endpoint errs towards returning more rather than less, so expect a few extra rows alongside what you asked for. Everything still comes back typed and parsed the same way.
POST
/api/public/v1/scrape/tiktok/stories
A creator's active stories. Use `limit` to say how many you want.
Returns video_feed_api
Parameters
Name
Required
Description
Example
username
required
Handle, with or without the @. Stories are gone 24 hours after posting.
nasa
Takes limit — how many results you want. The run is sized from it, and you are billed for exactly that many.
This endpoint errs towards returning more rather than less, so expect a few extra rows alongside what you asked for. Everything still comes back typed and parsed the same way.
POST
/api/public/v1/scrape/tiktok/followers
Accounts that follow this creator. Use `limit` to say how many you want.
Returns user_feed_api
Parameters
Name
Required
Description
Example
username
required
Handle, with or without the @.
nasa
Takes limit — how many results you want. The run is sized from it, and you are billed for exactly that many.
This endpoint errs towards returning more rather than less, so expect a few extra rows alongside what you asked for. Everything still comes back typed and parsed the same way.
POST
/api/public/v1/scrape/tiktok/following
Accounts this creator follows. Use `limit` to say how many you want.
Returns user_feed_api
Parameters
Name
Required
Description
Example
username
required
Handle, with or without the @.
nasa
Takes limit — how many results you want. The run is sized from it, and you are billed for exactly that many.
This endpoint errs towards returning more rather than less, so expect a few extra rows alongside what you asked for. Everything still comes back typed and parsed the same way.
This endpoint errs towards returning more rather than less, so expect a few extra rows alongside what you asked for. Everything still comes back typed and parsed the same way.
POST
/api/public/v1/scrape/tiktok/comments
Comments on a video. Use `limit` to say how many you want.
Returns comment_api
Parameters
Name
Required
Description
Example
video_id
required
Numeric id from the video URL.
7212345678901234567
Takes limit — how many results you want. The run is sized from it, and you are billed for exactly that many.
This endpoint errs towards returning more rather than less, so expect a few extra rows alongside what you asked for. Everything still comes back typed and parsed the same way.
POST
/api/public/v1/scrape/tiktok/replies
Replies to one comment. Use `limit` to say how many you want.
Returns comment_reply_api
Parameters
Name
Required
Description
Example
video_id
required
Numeric id from the video URL.
7212345678901234567
comment_id
required
Numeric id of the comment, from a `comments` run.
7213456789012345678
Takes limit — how many results you want. The run is sized from it, and you are billed for exactly that many.
This endpoint errs towards returning more rather than less, so expect a few extra rows alongside what you asked for. Everything still comes back typed and parsed the same way.
POST
/api/public/v1/scrape/tiktok/hashtag
Videos under a hashtag. Use `limit` to say how many you want.
Returns video_feed_api
Parameters
Name
Required
Description
Example
tag
required
Tag, with or without the
spacex
Takes limit — how many results you want. The run is sized from it, and you are billed for exactly that many.
This endpoint errs towards returning more rather than less, so expect a few extra rows alongside what you asked for. Everything still comes back typed and parsed the same way.
POST
/api/public/v1/scrape/tiktok/search
Videos matching a search. Use `limit` to say how many you want.
Returns video_feed_api
Parameters
Name
Required
Description
Example
query
required
What to search for. Hashtags and phrases both work.
mars landing
Takes limit — how many results you want. The run is sized from it, and you are billed for exactly that many.
This endpoint errs towards returning more rather than less, so expect a few extra rows alongside what you asked for. Everything still comes back typed and parsed the same way.
POST
/api/public/v1/scrape/tiktok/search_users
Creators matching a search. Use `limit` to say how many you want.
Returns user_feed_api
Parameters
Name
Required
Description
Example
query
required
A name or handle fragment to search for.
nasa
Takes limit — how many results you want. The run is sized from it, and you are billed for exactly that many.
This endpoint errs towards returning more rather than less, so expect a few extra rows alongside what you asked for. Everything still comes back typed and parsed the same way.
POST
/api/public/v1/scrape/tiktok/search_hashtags
Hashtags matching a search, with their view counts. Use `limit` to say how many you want.
Returns hashtag_api
Parameters
Name
Required
Description
Example
query
required
A keyword to find hashtags for. The leading
space
Takes limit — how many results you want. The run is sized from it, and you are billed for exactly that many.
This endpoint errs towards returning more rather than less, so expect a few extra rows alongside what you asked for. Everything still comes back typed and parsed the same way.
POST
/api/public/v1/scrape/tiktok/sound
One sound — its title, artist and how many videos use it.
Returns sound_api
Parameters
Name
Required
Description
Example
music_id
required
Numeric sound id, from the `music.id` of any video result.
This endpoint errs towards returning more rather than less, so expect a few extra rows alongside what you asked for. Everything still comes back typed and parsed the same way.
POST
/api/public/v1/scrape/tiktok/sound_videos
Videos using a sound. Use `limit` to say how many you want.
Returns video_feed_api
Parameters
Name
Required
Description
Example
music_id
required
Numeric sound id, from the `music.id` of any video result.
7678067441229990670
Takes limit — how many results you want. The run is sized from it, and you are billed for exactly that many.
This endpoint errs towards returning more rather than less, so expect a few extra rows alongside what you asked for. Everything still comes back typed and parsed the same way.
POST
/api/public/v1/scrape/tiktok/trending
What is trending in a country right now. Use `limit` to say how many you want.
Returns video_feed_api
Parameters
Name
Required
Description
Example
region
required
Two-letter country code — US, GB, JP, IN, BR.
US
Takes limit — how many results you want. The run is sized from it, and you are billed for exactly that many.
This endpoint errs towards returning more rather than less, so expect a few extra rows alongside what you asked for. Everything still comes back typed and parsed the same way.