TikTok trending

Fetch the videos TikTok is currently surfacing on its For You feed.

GET /v1/tiktok/trending

Query parameters

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

Example

curl -G "$LISTENX_BASE/v1/tiktok/trending" \
  -H "X-API-Key: $LISTENX_KEY" \
  --data-urlencode 'count=30' \
  --data-urlencode 'max_pages=2'

Response

{
  "source": "trending",
  "query": null,
  "pages_requested": 2,
  "pages_fetched": 2,
  "returned": 54,
  "results": [
    {
      "id": "7523456789012345678",
      "url": "https://www.tiktok.com/@creator/video/7523456789012345678",
      "type": "video",
      "desc": "this went viral overnight 😮",
      "author": { "unique_id": "creator", "nickname": "Creator" },
      "engagement": { "play_count": 5200000, "digg_count": 940000, "comment_count": 18200 }
    }
  ],
  "billing": {
    "endpoint": "tiktok.trending",
    "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.

Notes

• The For You feed is personalised and refreshes constantly; the same request can return different videos each time, and results are not exhaustive.

Billing

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