TikTok user videos

Fetch a public TikTok user's videos, newest first.

GET /v1/tiktok/user/{username}/videos

Path parameters

Parameter	Type	Description
username	string	Required. An @handle, a bare handle, or a profile URL.

Query parameters

Parameter	Type	Default	Description
count	integer	30	Videos requested per page. Maximum 35.
max_pages	integer	1	Number of pages to fetch. Maximum 20.

Example

curl -G "$LISTENX_BASE/v1/tiktok/user/charlidamelio/videos" \
  -H "X-API-Key: $LISTENX_KEY" \
  --data-urlencode 'max_pages=2'

Response

{
  "source": "user",
  "query": "charlidamelio",
  "pages_requested": 2,
  "pages_fetched": 2,
  "returned": 60,
  "results": [
    {
      "id": "7523456789012345678",
      "url": "https://www.tiktok.com/@charlidamelio/video/7523456789012345678",
      "type": "video",
      "desc": "new routine 💃",
      "created_at": "2025-06-12T15:25:12+00:00",
      "author": { "unique_id": "charlidamelio", "nickname": "charli d'amelio" },
      "engagement": {
        "play_count": 4200000,
        "digg_count": 810000,
        "comment_count": 12400,
        "share_count": 30500,
        "collect_count": 56000,
        "repost_count": 220
      },
      "music": { "id": "…", "title": "original sound", "is_original": true },
      "cover": "https://…",
      "duration": 18
    }
  ],
  "billing": {
    "endpoint": "tiktok.user_videos",
    "units": 2,
    "unit_price": "0.010000",
    "amount": "0.020000",
    "balance_after": "96.000000",
    "request_id": "…"
  }
}

Each item in results[] is a video record — the same shape returned by search with type=video. For complete details on a single video, call the post endpoint with its id.

Billing

Charged per page fetched — units = pages_fetched, minimum 1. See Billing.