TikTok Videos API

Endpoint

GET /v1/tiktok/videos

Parameters

query *

Search keyword (max 500 characters)

pages

Number of pages to fetch, 1-10 (default: 1)

region

2-letter region code (e.g. us, gb, jp)

publish_time

Time filter: 0=ALL, 1=24h, 7=week, 30=month, 90=3months, 180=6months (default: 0)

sort_by

Sort order: relevance, most_recent, most_liked (default: relevance)

Response fields

videos

Array of matching TikTok videos

title

Video title/caption

url

Direct link to the video

date

Publication date and time

author

TikTok username

source

Platform name (TikTok)

domain

tiktok.com

snippet

Video caption text

play_count

Number of plays/views

likes

Number of likes

comments

Number of comments

Number of shares

downloads

Number of downloads

duration

Video duration in seconds

is_ad

Whether the video is an ad

author_name

Author's display name

author_avatar

Author's avatar URL

cover

Video cover/thumbnail URL

music_title

Title of the music used

music_author

Author of the music used

pages

Number of pages fetched

count

Total results returned

Example Request

curl "https://apidirect.io/v1/tiktok/videos?query=cooking&pages=2&region=us&sort_by=relevance" \
  -H "X-API-Key: YOUR_API_KEY"

import requests

response = requests.get(
    "https://apidirect.io/v1/tiktok/videos",
    headers={"X-API-Key": "YOUR_API_KEY"},
    params={
        "query": "cooking",
        "pages": 2,
        "region": "us",
        "sort_by": "relevance"
    }
)
print(response.json())

Example Response

{
  "videos": [
    {
      "title": "Easy pasta recipe you need to try #cooking #recipe",
      "url": "https://www.tiktok.com/@chefmike/video/7312345678901234567",
      "date": "2026-02-20 18:45:30",
      "author": "chefmike",
      "source": "TikTok",
      "domain": "tiktok.com",
      "snippet": "Easy pasta recipe you need to try #cooking #recipe",
      "play_count": 2450000,
      "likes": 185000,
      "comments": 3200,
      "shares": 12500,
      "downloads": 8400,
      "duration": 45,
      "is_ad": false,
      "author_name": "Chef Mike",
      "author_avatar": "https://p16-sign.tiktokcdn.com/...",
      "cover": "https://p16-sign.tiktokcdn.com/...",
      "music_title": "original sound",
      "music_author": "chefmike"
    }
  ],
  "pages": 2,
  "count": 20
}

Frequently asked questions

How fresh is the TikTok data?

The TikTok Videos API provides real-time data, with results ranging from the last few years to a few seconds ago.

What engagement data is included?

Each video includes play count, likes, comments, shares, and downloads. You also get author metadata like display name and avatar, plus music information.

Can I filter by region?

Yes, use the region parameter with a 2-letter code (e.g. us, gb, jp) to get results relevant to a specific region.

What does the publish_time filter do?

The publish_time parameter filters results by when the video was published: 0 for all time, 1 for last 24 hours, 7 for last week, 30 for last month, 90 for last 3 months, or 180 for last 6 months.

How does pricing work?

You only pay for successful requests. The TikTok Videos API costs $0.006 per page. There are no monthly fees or commitments. You get 50 free requests per endpoint every month.

Do I need a credit card to start?

No. You can sign up and use the free tier (50 requests/endpoint/month) without adding a payment method. You only need to add a card when you want to exceed the free tier.

Are there rate limits?

Yes, there's a concurrency limit of 3 simultaneous requests per endpoint per user. If you need more, just get in touch.