TikTok Profile & Followers Scraper API: Fetch User Data, Videos & 200-Item Follower Lists

import requests

API_KEY = "tk_your_api_key_here"
BASE_URL = "https://api.shortvidapi.com"

def analyze_creator(username: str):
    # 1. Fetch profile & numeric user_id
    prof = requests.get(
        f"{BASE_URL}/v1/users/profile",
        params={"username": username.lstrip("@")},
        headers={"x-api-key": API_KEY},
        timeout=20,
    ).json()["data"]

    user_id = prof["user"]["id"]
    print(f"@{username} (user_id={user_id}): {prof['stats']['followerCount']:,} followers")

    # 2. Fetch up to 200 followers in a single request
    followers = requests.get(
        f"{BASE_URL}/v1/users/followers",
        params={"user_id": user_id, "limit": 200, "cursor": 0},
        headers={"x-api-key": API_KEY},
        timeout=20,
    ).json()["data"]
    return prof, followers

analyze_creator("tiktok")