TikTok/User Profile
User Profile Videos
GET
https://api.shofo.ai/tiktok/profileGet videos from a specific TikTok user's profile.
Pricing
Base cost: $0.001 per profile
- + Comments: $0.0001/post
- + Transcript: $0.0001/post (if available)
- + Video file: $0.0001/post
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
username | string | Optional | TikTok username (without @) |
sec_uid | string | Optional | User's sec_uid (alternative to username) |
count | integer | Required | Number of videos to retrieve |
cursor | string | Optional | Pagination cursor from previous response |
Note: You must provide either username or sec_uid. Using sec_uid is faster as it doesn't require a lookup.
Pagination
For users with many videos, use cursor-based pagination:
- Make initial request without
cursor - Extract
cursorfrom response - Pass cursor in next request to get more videos
- Repeat until
has_moreis false
Response Format
{
"success": true,
"data": {
"user": {
"username": "creator_username",
"sec_uid": "MS4wLjABAAAA...",
"nickname": "Creator Name",
"follower_count": 1500000,
"following_count": 500,
"like_count": 25000000,
"video_count": 150,
"bio": "Content creator | Business: email@example.com"
},
"videos": [
{
"video_id": "7123456789012345678",
"description": "My latest video #fyp",
"play_count": 500000,
"like_count": 50000,
"create_time": "2024-01-15T12:00:00Z",
"duration": 45
}
],
"cursor": "1705320000000",
"has_more": true
},
"cost": "$0.0010",
"request_id": "req_abc123"
}Try It
GET
https://api.shofo.ai/tiktok/profile$0.0001
Send a request to see the response