TikTok video API

Fetches public TikTok videos by URL or id and delivers description, creation time, author and author follower count, exact view/like/comment/share/save counts, duration, music and hashtags. Videos that are private, removed or region-locked come back under `failed` with TikTok's own reason — never billed as delivered. No login, no browser.

$0.004 per delivered video, up to 50 videos per run. Nothing delivered means nothing charged.

Inputs

• videos (array, required) — Video URLs (https://www.tiktok.com/@user/video/123…) or numeric ids.
• country (string) — ISO 3166-1 alpha-2 code — proxy exit geo and Google locale (gl). Omit for the default pool.
• max_results (integer) — How many videos to deliver at most (1–50). You pay only for delivered videos.

What one video looks like

• rank (integer) — 1-based delivery order.
• video_id (string) — TikTok video id.
• url (string) — Video URL.
• description (string, nullable) — Caption.
• created_at (string, nullable) — Publish time (ISO 8601).
• author (string, nullable) — Author handle.
• author_name (string, nullable) — Author display name.
• author_id (string, nullable) — Author id.
• author_verified (boolean) — Author verified badge.
• author_followers (integer, nullable) — Author follower count.
• views (integer, nullable) — Play count.
• likes (integer, nullable) — Like count.
• comments (integer, nullable) — Comment count.
• shares (integer, nullable) — Share count.
• saves (integer, nullable) — Save/collect count.
• duration_seconds (integer, nullable) — Duration in seconds.
• music (string, nullable) — Music title.
• music_author (string, nullable) — Music author.
• hashtags (string[]) — Hashtags in the caption.
• cover (string, nullable) — Cover image URL.

FAQ

What does the TikTok video API return?

Fetches public TikTok videos by URL or id and delivers description, creation time, author and author follower count, exact view/like/comment/share/save counts, duration, music and hashtags. Videos that are private, removed or region-locked come back under `failed` with TikTok's own reason — never billed as delivered. No login, no browser. Each row carries 20 fields, listed in full on this page.

What do I send it?

A semantic input, not a URL list: videos are required. One run returns up to 50 videos.

How much does the TikTok video API cost?

$0.004 per delivered video. A run that delivers nothing is not billed, and the