tiktok

Profile Videos

Scrapes videos from a TikTok profile. Pass cursor to get more videos.

get/v1/scrape/tiktok/videos

Request

  • Base URL: https://api.sociavault.com
  • URL: https://api.sociavault.com/v1/scrape/tiktok/videos
  • Auth: API key in header X-API-Key

Query parameters

handlestring required
Example:stoolpresidente

TikTok handle

user_idstring
Example:6659752019493208069

TikTok user id. Use this for faster responses.

sort_by'latest' | 'popular'
Example:latest

What to sort by (latest or popular)

max_cursorstring
Example:1734562353000

Cursor to get more videos. Get 'max_cursor' from previous response.

trimboolean

Set to true for a trimmed down version of the response

Response

Successful response

Key Response Fields:

  • aweme_list[0].image_post_info.images: Slideshow images (you'll want all of the 'thumbnail' images
  • aweme_list[0].video.dynamic_cover.url_list: Thumbnail
  • aweme_list[0].statistics: All the counts for views, likes, comments, etc. will be in this key
  • aweme_list[0].statistics.play_count: Views
  • aweme_list[0].statistics.digg_count: Likes
  • aweme_list[0].aweme_id: Id of the tiktok. No idea why they call it this, but aweme is a name you'll find everywhere in tiktok responses.
  • aweme_list[0].video.play_addr.url_list: Video without watermark
  • aweme_list[0].is_ad: Whether the tiktok is an ad. Make sure you're looking at the is_ad field and not the is_ads field
  • aweme_list[0].is_top: is_top: 1 means the tiktok is pinned
  • aweme_list[0].is_eligible_for_commission: If video is promoting an item from tiktok shop

Changes

No recorded changes to this operation across all 1 revision of this API.