TikTok Video API

Pull TikTok post metadata, engagement counts, captions, and author details as structured JSON, built for analytics and archiving at scale.

Get 100 Free Credits View Docs

A TikTok video API built for product teams

If you are searching for a TikTok video API, you almost certainly need three things working together: a clean way to pull a creator's full video feed, structured data for any single video, and a keyword search that returns ranked videos. TikLiveAPI delivers all three from one host, https://api.tikliveapi.com, with a single header for authentication and JSON responses you can read without reverse-engineering anything. Every request is a plain GET, so you can prototype in a browser tab, wire it into a cron job, or call it from a serverless function with no SDK to install.

This page focuses on the video-centric endpoints in the posts category. They are the building blocks behind competitor monitoring dashboards, content archivers, trend-research tools, and no-watermark download flows. Credits are deducted per call by the API itself, they never expire, and new accounts start with 100 free credits so you can validate the responses against your own use case before spending a cent. For profiles, hashtags and sounds, start from the TikTok scraper overview.

Pull a creator's full video feed

The /user-posts/ endpoint takes a numeric userid and returns a videos array. Each item carries the video_id, caption title, cover image, duration, the play URL, and the full stats block: play_count, digg_count, comment_count, share_count and collect_count. Page through an entire back catalog with the cursor field.

Get structured data for one video

Pass a video URL to /post-detail/ and receive a single object with the same rich stats plus three media URLs: play and wmplay for the standard stream and watermarked copy, and hdplay for the high-definition version. The nested music_info object identifies the original sound behind the clip.

Read every comment on a video

The /post-comments/ endpoint returns a comments array for any video URL. Each comment includes the text, its own digg_count, a reply_total, the create_time, and a nested user object identifying the commenter. Fetch up to 50 per call and walk the cursor to capture the whole thread for sentiment analysis; the comment scraping guide covers replies and collection at scale.

Search videos by keyword

The /search-video/ endpoint takes a keyword and returns ranked videos in the same shape as the user feed. Narrow results with publish_time (past 24 hours through last 6 months), reorder with sort_by (relevance, like count, or date posted), and target a market with the optional region code.

Get no-watermark download links

Both /post-detail/ and the dedicated /download-video/ endpoint expose direct URLs to clean, watermark-free MP4 streams - play on the detail response, video and video_hd on the download endpoint. These are the same links you can hand to a downloader or pipe into an archive job, with the watermarked variant available in wmplay when you need it. The TikTok video download API page covers both download endpoints, MP3 audio included.

Follow a sound, hashtag, or playlist

Beyond single videos, the posts category fans videos out by source: /music-posts/ lists clips using a given sound, /challenge-posts/ streams videos behind a hashtag, and /playlist-posts/ returns an ordered series. All share the familiar videos shape with count and cursor pagination. To turn these feeds into a collection pipeline for whole channels, hashtags or search results, see the video scraping workflow.

Quick start

Authentication is one header, X-Api-Key. Here is a real, runnable request that fetches the most recent videos from the official TikTok account (user ID 107955):

curl "https://api.tikliveapi.com/user-posts/?userid=107955" \
  -H "X-Api-Key: YOUR_API_KEY"

The response is a videos array. Trimmed to the fields that matter for analytics, a single item looks like this:

{
  "videos": [
    {
      "video_id": "7689568478570843422",
      "title": "the throwback sounds we didn’t know we were missing, given new life on the FYF 💖 @Adam Barrera unpacks how you made this the summer of nostalgia.",
      "duration": 52,
      "play_count": 266509,
      "digg_count": 3632,
      "comment_count": 1315,
      "share_count": 284,
      "collect_count": 320,
      "create_time": 1790367199,
      "author": { "id": "107955", "unique_id": "tiktok", "nickname": "TikTok" }
    }
  ]
}

Swap user-posts for search-video?keyword=cat and you get the same video shape for any keyword. Every field above is returned verbatim by the API, so your parsing code is identical across the user feed, search, music, hashtag, and playlist endpoints.

Common use cases

Competitor and brand monitoring

Poll /user-posts/ on a schedule for the accounts you track, store each video_id with its stats, and watch how play_count and digg_count move over time. This is the data spine behind any dashboard that monitors competitor TikTok accounts at scale.

Trend research and discovery

Run /search-video/ with publish_time=1 and sort_by=1 to surface videos from the last 24 hours ranked by likes. It is a fast read on what is gaining traction for a keyword, and pairs naturally with hashtag tracking from /challenge-posts/.

No-watermark archiving

Resolve any video URL through /post-detail/, grab the clean play or hdplay link, and download it for a content archive or compliance record. Bulk archive pipelines combine this with playlist and user-feed enumeration to capture entire catalogs.

Comment and sentiment analysis

Stream a video's full discussion with /post-comments/, page through the cursor, and feed the text values into a sentiment or summarization pipeline. The per-comment digg_count and reply_total let you weight the loudest voices.

Start with 100 free credits

Create an account and you get 100 credits to spend across any of these video endpoints, no card required. Test live in the playground, copy the generated code snippet, and ship. Credits are pay-as-you-go and never expire, so you only pay for the calls you actually make.

Key facts

Base URL and authentication: send requests to https://api.tikliveapi.com with your API key in the X-Api-Key header.
Credits: 1 successful request = 1 credit; failed requests don't use credits.
No expiry: credits never expire, and there are no monthly plans.
Free credits: 100 free credits on signup.
Rate limit: the standard rate limit is 200 requests per minute per API key.
Errors: a missing or invalid API key returns a JSON object with a message field and HTTP status 200, so check the response body rather than relying on the status code.
Data handling: data is fetched live from TikTok and passed straight to you; TikLiveAPI does not store or cache it.
Payment: crypto via Cryptomus. Card payments are temporarily unavailable.

Frequently Asked Questions

How do I authenticate requests to the TikTok video API?

Every request is a GET that includes your API key in the X-Api-Key header. There is no OAuth flow and no SDK to install. The API host is https://api.tikliveapi.com, and each endpoint returns plain JSON.

How many videos can I retrieve in a single call?

The /user-posts/ and /search-video/ endpoints return up to 35 videos per call (the count parameter defaults to 10). The /post-comments/ endpoint returns up to 50 comments per call. To go beyond those limits, pass the cursor value from the previous response to fetch the next page.

How does pagination work?

Most video endpoints use cursor-based pagination: each response includes a cursor you send back on the next request to continue where you left off. The user-followers and user-following endpoints page by a time timestamp instead, but for posts, search, comments, music, hashtag, and playlist feeds you always use cursor.

Can I download videos without a watermark?

Yes. The /post-detail/ endpoint returns a clean play URL and an hdplay high-definition URL alongside the watermarked wmplay link, and the dedicated /download-video/ endpoint returns no-watermark download links directly from a video URL.

Do credits expire?

No. Credits are pay-as-you-go and never expire. New accounts start with 100 free credits, and the external API deducts credits per call, so you only pay for the requests you actually make.

Start building with real-time TikTok data today.