TikTok

TikTok User Videos

Get a user's videos, newest first, by username, numeric user ID, or profile URL. Returns the caption, link, publication date, engagement metrics (plays, likes, comments, shares, downloads, saves), playback and download URLs, cover images, the sound used, and author details for each video. Supports fetching multiple pages in a single API call (billed per page).

Price: $0.006 per page. Free tier: 50 requests/month.

get/v1/tiktok/user/videos

Request

  • Base URL: https://apidirect.io
  • URL: https://apidirect.io/v1/tiktok/user/videos
  • Auth: API key in header X-API-Key

Query parameters

usernamestring

TikTok username, with or without leading @ (max 100 characters). Provide exactly one of username, user_id, or url.

user_idstring

Numeric TikTok user ID, as returned by Search Users or User Profile. Provide exactly one of username, user_id, or url.

urlstring

TikTok profile URL, e.g. https://www.tiktok.com/@tiktok (max 500 characters). Provide exactly one of username, user_id, or url.

pagesinteger

Number of pages to fetch, 1-1000 (default: 1). Each page returns up to 30 videos.

get_sentimentboolean

Set to true to add AI emotion analysis to each item. Adds a sentiment object containing emotions (joy, trust, fear, surprise, sadness, disgust, anger and anticipation, each scored 0-100), dominant_emotion, emotional_intensity (0-10), and polarity (positive, negative or neutral). Any item that cannot be scored returns sentiment: null.

Response

Successful response

usernamestring nullable
pagesnumber nullable
countnumber nullable

Changes

No recorded changes to this operation across all 1 revision of this API.