TikTok hashtag videos

Fetch videos tagged with a hashtag, by its numeric hashtag id.

GET /v1/tiktok/hashtag/{challenge_id}/videos

Getting a hashtag id

A hashtag is addressed by a numeric id, not its text name. Look it up with GET /v1/tiktok/search?type=hashtag — the id field on each result is the hashtag id to pass here.

Path parameters

Parameter	Type	Description
challenge_id	string	Required. The numeric hashtag id.

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/hashtag/42164/videos" \
  -H "X-API-Key: $LISTENX_KEY" \
  --data-urlencode 'max_pages=2'

Response

{
  "source": "hashtag",
  "query": "42164",
  "pages_requested": 2,
  "pages_fetched": 2,
  "returned": 58,
  "results": [
    {
      "id": "7523456789012345678",
      "url": "https://www.tiktok.com/@doc/video/7523456789012345678",
      "type": "video",
      "desc": "3 tips for whiter teeth #dentalcare",
      "created_at": "2025-06-12T15:25:12+00:00",
      "author": { "unique_id": "doc", "nickname": "Dr. Smile" },
      "engagement": { "play_count": 185300, "digg_count": 4045, "comment_count": 238 }
    }
  ],
  "billing": {
    "endpoint": "tiktok.hashtag_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.

Billing

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