# TikTok Profile Videos API (https://www.socialcrawl.dev/platforms/tiktok/profile-videos)

> Returns a paginated list of recent public videos posted by a TikTok user. Each video includes view count, like count, comment count, share count, caption, and thumbnail URL.

TL;DR: `GET /v1/tiktok/profile/videos` costs 1 credit per call and returns SocialCrawl's unified JSON schema. Single x-api-key auth, 100 free credits on signup.

## Parameters

| Parameter | Required | Description |
| --- | --- | --- |
| `handle` | yes | TikTok username without the @ symbol |
| `user_id` | no | TikTok user id. Use this for faster responses. |
| `sort_by` | no | What to sort by (latest \| popular) |
| `max_cursor` | no | Cursor to get more videos. Get 'max_cursor' from previous response. |
| `region` | no | Region (Country) you want the proxy in. Defaults to US. |
| `trim` | no | Set to true for a trimmed down version of the response |

## Code example

```bash
curl "https://www.socialcrawl.dev/v1/tiktok/profile/videos?handle=charlidamelio" \
  -H "x-api-key: sc_YOUR_API_KEY"
```

## FAQ

### How do I list a TikTok user's videos with an API?

Send a GET request to /v1/tiktok/profile/videos with the handle parameter. SocialCrawl returns a paginated list of that user's recent public videos with view, like, comment, and share counts plus captions and thumbnail URLs.

### What fields does the TikTok Videos endpoint return?

Each video includes video id, url, caption, view count, like count, comment count, share count, duration, thumbnail URL, creation timestamp, and author handle in a unified schema.

### How do I paginate through all of a user's TikTok videos?

Read the max_cursor field from the response and pass it as the max_cursor parameter on your next request. Repeat until max_cursor is empty or you have the volume you need.

### Can I sort TikTok videos by popularity?

Yes. Pass sort_by=popular to get the most-viewed videos first, or sort_by=latest (default) for newest-first ordering. Both work with the handle or the user_id parameter.

### How much does the TikTok Videos API cost?

Each request costs 1 credit on the standard tier regardless of how many videos are returned in the page. New accounts get 100 free credits with no credit card required.

See the full TikTok API: https://www.socialcrawl.dev/platforms/tiktok

## Pricing

- Standard endpoints: 1 credit per call
- Advanced endpoints: 5 credits per call
- Premium endpoints: 10 credits per call
- 100 free credits on signup, no credit card required. Cached responses cost 0 credits. Credit packs never expire.
- Full pricing: https://www.socialcrawl.dev/pricing

## Explore with AI

Questions this API answers, phrased for an AI assistant:

- How to list a TikTok user's videos with the SocialCrawl API
- What does the SocialCrawl TikTok Videos endpoint return?