curl --request GET \
--url https://api.sociavault.com/v1/scrape/tiktok/search/keyword \
--header 'X-API-Key: <api-key>'Scrapes TikTok videos matching a keyword
curl --request GET \
--url https://api.sociavault.com/v1/scrape/tiktok/search/keyword \
--header 'X-API-Key: <api-key>'Keyword to search for
Time Frame
yesterday, this-week, this-month, last-3-months, last-6-months, all-time "all-time"
Sort by
relevance, most-liked, date-posted "relevance"
Note, this doesn't filter the tiktoks only in a specfic region, it puts the proxy there. Use it in case you want to scrape posts only available for some country. Use 2 letter country codes like US, GB, FR, etc
Cursor to get more videos. Get 'cursor' from previous response.
10
Set to true to get a trimmed response
Successful response
Key Response Fields:
data.search_item_list[].aweme_info.aweme_id: Video IDdata.search_item_list[].aweme_info.desc: Caption/description textdata.search_item_list[].aweme_info.create_time: Unix timestamp of when the video was posteddata.search_item_list[].aweme_info.statistics.play_count: Total viewsdata.search_item_list[].aweme_info.statistics.digg_count: Likesdata.search_item_list[].aweme_info.statistics.comment_count: Commentsdata.search_item_list[].aweme_info.statistics.share_count: Sharesdata.search_item_list[].aweme_info.statistics.collect_count: Bookmarks/savesdata.search_item_list[].aweme_info.video.play_addr.url_list[0]: Video playback URLdata.search_item_list[].aweme_info.video.bit_rate[0].play_addr.url_list[0]: Highest quality video URLdata.search_item_list[].aweme_info.video.cover.url_list[0]: Thumbnail image URLdata.search_item_list[].aweme_info.video.duration: Video duration in millisecondsdata.search_item_list[].aweme_info.author.unique_id: Author's TikTok usernamedata.search_item_list[].aweme_info.author.nickname: Author's display namedata.search_item_list[].aweme_info.author.sec_uid: Author's secure user IDdata.search_item_list[].aweme_info.music.title: Sound/music titledata.search_item_list[].aweme_info.music.play_url.url_list[0]: Audio playback URLdata.cursor: Pagination cursor — pass as cursor parameter to get the next pagedata.has_more: Whether more results are available (1 = yes)