TikTok Research API: Academic Eligibility, 1,000/Day Quota & Commercial REST Endpoints

import requests

API_KEY = "tk_live_your_api_key"
HEADERS = {"x-api-key": API_KEY}

def fetch_research_dataset(keyword: str, region: str = "US"):
    # 1. Search videos matching research topic
    search_res = requests.get(
        "https://api.tiktokapi.io/v1/video/search",
        params={"keywords": keyword, "region": region, "count": 20, "publish_time": 30},
        headers=HEADERS,
        timeout=25,
    ).json()

    videos = search_res.get("data", {}).get("videos", [])
    dataset = []

    for v in videos[:5]:
        vid = v.get("video_id") or v.get("id")
        # 2. Pull comments for discourse analysis
        comments_res = requests.get(
            "https://api.tiktokapi.io/v1/comment/list",
            params={"url": vid, "count": 50, "cursor": 0},
            headers=HEADERS,
            timeout=25,
        ).json()
        dataset.append({
            "video_id": vid,
            "author": v.get("author", {}).get("unique_id"),
            "title": v.get("title"),
            "play_count": v.get("play_count"),
            "digg_count": v.get("digg_count"),
            "share_count": v.get("share_count"),
            "comment_sample_size": len(comments_res.get("data", {}).get("comments", [])),
        })
    return dataset

if __name__ == "__main__":
    print(fetch_research_dataset("electric vehicles"))