TikTok Search API Guide: Search Videos, Creators & Commercial Ads by Keyword

import requests

API_KEY = "tk_your_api_key_here"

def search_tiktok_videos(query: str, region: str = "US", max_pages: int = 3):
    cursor = 0
    collected = []
    for page in range(max_pages):
        res = requests.get(
            "https://api.shortvidapi.com/v1/videos/search",
            params={
                "query": query,
                "limit": 30,
                "cursor": cursor,
                "region": region,
                "publish_time": 0,  # 0=All, 1=Yesterday, 7=7d, 30=30d, 90=90d, 180=180d
                "sort_by": 0,       # 0=Relevance, 1=Most Liked, 3=Newest
            },
            headers={"x-api-key": API_KEY},
            timeout=20,
        )
        res.raise_for_status()
        body = res.json()
        if body["code"] != 0:
            break

        data = body["data"]
        videos = data.get("videos", [])
        collected.extend(videos)

        if not data.get("hasMore") or not videos:
            break
        cursor = data.get("cursor", 0)
    return collected

videos = search_tiktok_videos("ai tools", region="US", max_pages=2)
print(f"Fetched {len(videos)} videos. Top result: {videos[0]['title'][:70]}")