Can the TikTok Display API fetch another user's public videos by username?

No. The Display API's /v2/video/list/ endpoint only reads videos owned by the user whose OAuth 2.0 Bearer token is passed in the Authorization header. To fetch public videos for any @username, use GET /v1/user/posts on TikTokAPI.io.

Does the TikTok Display API return direct MP4 video download links?

No. Display API v2 returns an embed_link and embed_html iframe snippet along with a temporary cover_image_url. To get direct 1080p unwatermarked MP4 URLs (data.hdplay), call GET /v1/video/detail on TikTokAPI.io.

OAuth & Scopes Reference · 20266 min read·Updated 2026-11-04

TikTok Display API: OAuth 2.0 Scopes, Limitations & How to Fetch Public Profiles

The Official TikTok Display API is built for 'Login with TikTok' portfolio widgets — it cannot look up other creators, hashtags, comments, or unwatermarked MP4 streams. Here is the exact scope breakdown and how to query public TikTok accounts without OAuth.

Get Free API Key (10,500 Free Credits) →Run Live Code Example ↓

$0.20 / 1K Videos · $0.10 / 1K Comments & Followers · No OAuth Needed

Instant Quickstart · Copy & Run in 30 Seconds

Query Any Public @username Profile & Latest Videos

Execute in Live Playground →

import requests

API_KEY = "tk_live_your_api_key"

def fetch_public_creator(username: str):
    profile = requests.get(
        "https://api.tiktokapi.io/v1/user/info",
        params={"unique_id": username.lstrip("@")},
        headers={"x-api-key": API_KEY},
        timeout=20,
    ).json()["data"]

    posts = requests.get(
        "https://api.tiktokapi.io/v1/user/posts",
        params={"unique_id": username.lstrip("@"), "count": 33},
        headers={"x-api-key": API_KEY},
        timeout=20,
    ).json()["data"]

    return {
        "user": profile["user"],
        "stats": profile["stats"],
        "recent_videos_fetched": len(posts.get("videos", [])),
    }

if __name__ == "__main__":
    print(fetch_public_creator("tiktok"))

Key Engineering Takeaways (TL;DR)

✓Every TikTok Display API endpoint requires a per-user OAuth 2.0 access_token obtained via Login Kit browser redirect.
✓The Display API only returns data belonging to the currently logged-in user (user.info.basic, user.info.stats, video.list, video.query). You cannot pass another creator's @username.
✓Each OAuth scope requires a separate TikTok Developer Portal app review with screen recordings demonstrating user consent.
✓To fetch any public creator's profile, videos, or followers by @username without asking them to log in, call GET /v1/user/info and GET /v1/user/posts on TikTokAPI.io.

1. TikTok Display API OAuth 2.0 Scopes & Field Restrictions

The Display API splits creator data across three permission scopes, all restricted to the authenticated token holder:

Official TikTok Display API v2 scopes vs TikTokAPI.io public lookup endpoints
OAuth Scope	Display API v2 Endpoint	Fields Returned (Own Account Only)	Public @username Equivalent on TikTokAPI.io
user.info.basic	GET /v2/user/info/	open_id, union_id, avatar_url, display_name	GET /v1/user/info?unique_id=@handle (no OAuth)
user.info.profile	GET /v2/user/info/	bio_description, profile_deep_link, is_verified	Included in GET /v1/user/info response
user.info.stats	GET /v2/user/info/	follower_count, following_count, likes_count, video_count	Included in GET /v1/user/info data.stats
video.list	POST /v2/video/list/	User's own public videos (max 20/page, embed link only)	GET /v1/user/posts?unique_id=@handle (33/page + 1080p MP4)

2. Fetching Any Public Creator Profile & Videos Without User OAuth

When building influencer discovery tools, competitor trackers, or social listening dashboards, you cannot ask thousands of creators to complete an OAuth login flow. Query their public @username directly instead:

Query Any Public @username Profile & Latest Videos

Fetches full profile statistics and recent 1080p videos for any public TikTok handle using a single API key.

# Fetch public profile & stats for any @username (no OAuth required)
curl -sS "https://api.tiktokapi.io/v1/user/info?unique_id=khaby.lame" \
  -H "x-api-key: tk_live_your_api_key"

# Fetch up to 33 latest public videos for @username
curl -sS "https://api.tiktokapi.io/v1/user/posts?unique_id=khaby.lame&count=33" \
  -H "x-api-key: tk_live_your_api_key"

Interactive Engineering Workbench · GET /v1/user/info

Verify real-time latency, pagination math & JSON schema

Videos scraped per day (2 Credits / video, up to 33/call)5,000 videos/day

Comments extracted per day (1 Credit / comment, up to 50/call)10,000 comments/day

Followers mapped per day (1 Credit / user, up to 200/call)20,000 followers/day

Our HTTP Calls/Day

452

Large page sizes

Legacy Provider Calls

1,334

30-item small pages

Official Research API

Within 1K Cap

1,000 req/day limit

Estimated Monthly Pipeline Cost (30 Days)

$72.73/ mo with Business bonus ($120.00 base rate)

Daily consumption: 40,000 Credits ($4.00/day)

TikTokAPI.io (with volume bonus):$72.73 / mo

Legacy Scrapers ($1.50 / 1K calls):$60.03 / mo

Failed / 404 request fee:$0.00 (0 Credits)

Start Free (10,500 Credits · $1.05) →Full Rate Card

Frequently Asked Questions

Can the TikTok Display API fetch another user's public videos by username?: No. The Display API's /v2/video/list/ endpoint only reads videos owned by the user whose OAuth 2.0 Bearer token is passed in the Authorization header. To fetch public videos for any @username, use GET /v1/user/posts on TikTokAPI.io.
Does the TikTok Display API return direct MP4 video download links?: No. Display API v2 returns an embed_link and embed_html iframe snippet along with a temporary cover_image_url. To get direct 1080p unwatermarked MP4 URLs (data.hdplay), call GET /v1/video/detail on TikTokAPI.io.