---
title: "Profile Videos"
method: GET
path: "/v1/scrape/tiktok/videos"
tags: ["tiktok"]
---

# Profile 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`

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

## Query parameters

- `handle` string, required
- `user_id` string
- `sort_by` 'latest' | 'popular'
- `max_cursor` string
- `trim` boolean

## Response `200`

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

## Other responses

- `400`: Bad Request - Invalid parameters or missing required fields
- `401`: Unauthorized - Invalid or missing API key
- `402`: Payment Required - Insufficient credits
- `500`: Internal Server Error - Service configuration or processing error

---

[API](https://skmtc.dev/sociavault/apis/sociavault-api.md) · [All operations](https://skmtc.dev/sociavault/apis/sociavault-api/llms.txt) · [OpenAPI document](https://skmtc.dev/sociavault/apis/sociavault-api/revisions/0a430c97f53a?raw)