---
title: "Get top TikTok videos from the last 24-48 hours"
method: GET
path: "/v1/tiktok/videos/digest"
tags: ["TikTok"]
---

# Get top TikTok videos from the last 24-48 hours

`GET /v1/tiktok/videos/digest`

## Request

- Base URL: `https://api.virlo.ai`
- URL: `https://api.virlo.ai/v1/tiktok/videos/digest`
- Auth: HTTP bearer

Returns the top TikTok videos published recently, ordered by view count.

## Query parameters

- `limit` number

## Response `200`

Successfully retrieved top TikTok videos

- V1VideoDigestResponseDto
  - `data` V1VideoDigestItemDto[], required
    - `id` string, required
    - `url` string, required
    - `type` string, required: Platform type
    - `description` string, nullable
    - `publish_date` string, nullable
    - `views` number, required
    - `number_of_likes` number
    - `number_of_comments` number
    - `number_of_shares` number
    - `bookmarks` number: Save/bookmark count.
    - `hashtags` string[]
    - `thumbnail_url` string, nullable
    - `duration` number, nullable: Duration in seconds.
    - `external_id` string: Platform-native video id.
    - `author_id` string, nullable: Author id; null when the author row is not linked yet.
    - `niche` string, nullable: AI-inferred niche slug.
    - `region` string, nullable: Resolved upload region (ISO 3166-1 alpha-2), when available.
    - `upload_region` string, nullable
    - `upload_region_source` string, nullable: How upload_region was resolved.
    - `transcript_raw` string, nullable: Raw transcript when available.
    - `is_eligible_for_commission` boolean, nullable: TikTok commission eligibility.
    - `is_duet` boolean: Whether this video is a TikTok duet. Always false for YouTube/Instagram.
    - `is_stitch` boolean: Whether this video is a TikTok stitch. Always false for YouTube/Instagram.
    - `sound` V1VideoDigestSoundDto
      - `id` string, required
      - `title` string, nullable
      - `duration` number, nullable
      - `cover_url` string, nullable: Sound cover image URL. Always an absolute URL (or null). Images Virlo stores are served from https://auth.virlo.ai/storage/v1/object/public/<bucket>/; platform CDN links are passed through. Some files are HEIC, which most non-Safari browsers cannot render, so convert before display if you need to.
      - `owner_handle` string, nullable
      - `owner_nickname` string, nullable
      - `is_original` boolean, nullable
      - `is_commerce_music` boolean, nullable
      - `usage_count` number, nullable
      - `platform` string, nullable

## Other responses

- `400`: Bad request - invalid parameters
- `401`: Unauthorized - missing or invalid API key
- `429`: Too many requests - rate limit exceeded

---

[API](https://skmtc.dev/virlo/apis/virlo-public-api.md) · [All operations](https://skmtc.dev/virlo/apis/virlo-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/virlo/apis/virlo-public-api/revisions/3b69c6145087?raw)