TikTok Videos

The TikTok videos endpoint provides access to the top-performing TikTok videos published in the last 48 hours.

GET/v1/tiktok/videos/digest

Get TikTok videos digest

Returns the top TikTok videos published in the last 48 hours, ordered by view count (highest first).

Cost per request:

Query parameters

Name
limit
Type
number
Description
Number of top videos to return (1-100). Default is 50.

Request

GET

/v1/tiktok/videos/digest

curl -G https://api.virlo.ai/v1/tiktok/videos/digest \
  -H "Authorization: Bearer {token}" \
  -d limit=50

Response

{
  "data": [
    {
      "id": "65e6604e-7469-4c6c-aa49-cb93b6feac36",
      "url": "https://www.tiktok.com/@dailymail/video/7564023786111028535",
      "publish_date": "2025-10-22T13:00:00",
      "views": 10439698,
      "number_of_likes": 865067,
      "number_of_comments": 12065,
      "description": "Kim Kardashian and Kanye West's daughter North West is going viral for her new appearance, sparking massive debate online 😳 #northwest #kardashians #celebrity #viral",
      "thumbnail_url": "https://auth.virlo.ai/storage/v1/object/public/thumbnails/8dfc5b77-72aa-4965-baac-e6627c308ad9.jpg",
      "hashtags": ["northwest", "kardashians", "celebrity", "viral"],
      "type": "tiktok",
      "niche": "celebrities",
      "author_id": "16244f6f-4d83-44b2-a627-612f700065ea",
      "bookmarks": 22108,
      "external_id": "7564023786111028535",
      "region": "US",
      "duration": 65,
      "transcript_raw": null
    },
    {
      "id": "b51c2109-d402-4f31-9fd5-938acbd48aee",
      "url": "https://www.tiktok.com/@moviescins8k/video/7564027987218287903",
      "publish_date": "2025-10-22T12:51:58",
      "views": 9632829,
      "number_of_likes": 263819,
      "number_of_comments": 1005,
      "description": "Stranger Things Season 5 plot details revealed! The final season picks up after Vecna's devastating attack on Hawkins 🔥 #strangerthings5 #netflix #strangerthings #vecna",
      "thumbnail_url": "https://auth.virlo.ai/storage/v1/object/public/thumbnails/d009dbb6-d928-4e54-91a7-ef9d173d5b37.jpg",
      "hashtags": null,
      "type": "tiktok",
      "niche": "movies-tv",
      "author_id": "d9c14f71-9957-472c-b3e2-9413e14242ca",
      "bookmarks": 22048,
      "external_id": "7564027987218287903",
      "region": "US",
      "duration": 59,
      "transcript_raw": "This is the video transcript..."
    }
  ]
}

Error responses

The TikTok videos digest endpoint may return the following error codes:

Name
400 Bad Request
Description
Invalid parameters provided. Common causes include: - Invalid limit value (must be 1-100)
Name
401 Unauthorized
Description
Missing or invalid API key. Ensure you're including your API key in the Authorization header.
Name
429 Too Many Requests
Description
Rate limit exceeded. Your plan has specific rate limits per endpoint. Wait before making additional requests.