TikTok

Search TikTok Videos

Search for TikTok videos by keyword. Returns video caption, a link to the video on TikTok, publish date, engagement metrics (plays, likes, comments, shares, downloads), duration, cover image, music track, and creator metadata (username, display name, avatar). Supports region filtering, publish-time filtering, and sorting by relevance, recency, or likes. Supports fetching multiple pages in a single API call (billed per page). Set get_sentiment=true to add AI emotion analysis to each video.

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

get/v1/tiktok/videos

Request

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

Query parameters

querystring required

Search query (max 500 characters)

pagesinteger

Number of pages to fetch and merge (1-10). Each page returns up to 30 videos. Billed per page.

regionstring

2-letter region code to filter by (e.g., us, gb, jp, de, fr)

publish_time0 | 1 | 7 | 30 | 90 | 180

Filter by publish time in days: 0 = all time, 1 = last day, 7 = last week, 30 = last month, 90 = last 3 months, 180 = last 6 months. Any other number returns 400; a non-numeric value falls back to 0.

sort_by'relevance' | 'most_recent' | 'most_liked'

Sort order for results. Any unrecognised value falls back to relevance.

get_sentimentboolean

Set to true to add AI emotion analysis to each video. 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 video that cannot be scored returns sentiment: null.

Response

Successful response

countnumber nullable
pagesnumber nullable

Changes

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