Engineering Guides · Architecture · Cost Benchmarks

Production guides for TikTok data pipelines.

Practical, code-first references written for backend engineers, AI workflow builders, and data teams. Every guide includes working Python, TypeScript, and cURL examples plus verified response schemas.

Architecture Guide · 20268 min read · Updated 2026-10-29

Unofficial TikTok API vs Official TikTok API: Complete 2026 Developer Guide

Why 95% of social listening platforms, AI video pipelines, and e-commerce intelligence tools use an independent TikTok data gateway instead of ByteDance's restricted OAuth endpoints — with production Python & TypeScript examples.

→The Official TikTok Display API requires per-user OAuth 2.0 login and only returns videos owned by the authenticated user — you cannot look up arbitrary public creators, hashtags, or competitors.
→The Official TikTok Research API is restricted to vetted non-profit academic institutions and prohibits commercial SaaS, brand monitoring, or AI training use cases.

GET /v1/user/infoGET /v1/video/detail

Video Parser Guide · 1080p HD6 min read · Updated 2026-10-29

How to Get TikTok Video Metadata & 1080p No-Watermark MP4 via API

Extract complete video metadata, play/digg/comment/share counts, author profile, sound track, photo mode image slides, and direct 1080p HD unwatermarked video streams in a single GET request.

→Pass any TikTok full URL (tiktok.com/@user/video/123), short share link (vm.tiktok.com / vt.tiktok.com), or raw numeric video ID to GET /v1/videos/detail (or /v1/video/detail).
→Set hd=1 (enabled by default) to receive both the fast standard unwatermarked stream (data.play) and the 1080p original HD stream (data.hdplay).

GET /v1/video/detailGET /v1/comment/list

Search & Discovery Guide7 min read · Updated 2026-10-29

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

Build real-time trend discovery, social listening, influencer outreach, and ad intelligence pipelines with keyword search across TikTok videos, creators, hashtags, and Creative Center ads.

→Use GET /v1/videos/search (or /v1/video/search) to search public videos by keyword with filters for region (US, GB, JP, DE, etc.), publish_time (yesterday, 7d, 30d, 90d, 180d), and sort_by (Relevance, Most Liked, Newest).
→Every video item returned in search results already includes direct no-watermark MP4 playback links (play) and full engagement counters — no second N+1 lookup required.

GET /v1/video/searchGET /v1/user/search

Pricing & Cost Analysis · 20266 min read · Updated 2026-10-29

TikAPI Pricing Breakdown (2026): Real Cost per 1,000 Videos & Pay-As-You-Go Comparison

Why per-request pricing on small page sizes inflates your actual TikTok scraping bill by 5x–10x — and how item-based credit pricing with 200-user follower pages cuts monthly infrastructure spend by up to 80%.

→Legacy providers price by 'API request' while capping each page at 30 videos or 30 followers — meaning 1,000,000 followers requires ~33,334 requests.
→ShortVid API returns up to 200 followers per request and bills transparently by item ($0.20 / 1K videos, $0.10 / 1K comments or followers at base rate; down to $0.08 / 1K videos with Business bonus).

Pricing & PlansShortVid API vs TikAPI

Troubleshooting · HTTP Error 403 & WAF Fix8 min read · Updated 2026-11-05

Fix TikTok HTTP Error 403 ("Access to www.tiktok.com Was Denied") — Working Python & API Bypass

Getting "Access to www.tiktok.com was denied. You don't have authorization to view this page. HTTP ERROR 403" or "The server at www.tiktok.com sent back an error: 403 Forbidden"? Diagnose the exact WAF layer in 30 seconds — or bypass 403 blocks from any cloud IP without proxies or cookies.

→TikTok returns HTTP 403 Forbidden (or HTTP 200 with a 0-byte Content-Length body) when a request lacks valid X-Bogus / X-Argus / msToken signatures or originates from a flagged cloud datacenter ASN (AWS, GCP, Hetzner, DigitalOcean).
→The Chrome/Edge interstitial "Access to www.tiktok.com was denied. You don't have authorization to view this page. HTTP ERROR 403" comes from TikTok's Akamai/ByteDance Edge WAF flagging VPN, proxy, or cloud datacenter IPs.

GET /v1/video/detailGET /v1/user/info

Ad Intelligence Tutorial8 min read · Updated 2026-10-29

TikTok Ads Library & Creative Center API: Scrape Winning Ads, CTR & Keywords

Query TikTok Creative Center's commercial ad database by keyword, country, and time window (7/30/180 days) to extract winning e-commerce ad videos, advertiser landing pages, and high-converting ad copy.

→Unlike TikAPI and most unofficial scrapers that only cover organic posts, ShortVid API includes full access to the TikTok Creative Center Commercial Ads Library (/v1/ads/search and /v1/ads/detail).
→Search commercial ads by product keyword (e.g., 'bracelet', 'serum', 'ai app'), target country (US, GB, DE, JP, BR, etc.), time window (7, 30, or 180 days), and sort by impression, like, or ctr.

GET /v1/ads/top/adsGET /v1/ads/top/ads/detail

Social Listening Tutorial7 min read · Updated 2026-10-31

TikTok Comments & Replies Scraper API: Extract Threads at $0.10/1K

Extract top-level TikTok comments, nested reply conversations, like counts, and commenter profiles at 50 comments per request ($0.10 per 1,000 comments) for AI sentiment analysis and lead generation.

→GET /v1/videos/comments (alias GET /v1/comment/list) returns up to 50 top-level comments per request at 1 Credit ($0.0001) per comment — $0.10 per 1,000 comments.
→Every comment object includes cid (comment ID), text, digg_count (likes), reply_comment_total, create_time, and commenter profile metadata (uid, unique_id, sec_uid).

GET /v1/comment/listGET /v1/comment/reply

Creator & Follower Graph Guide8 min read · Updated 2026-11-04

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

Scrape TikTok follower lists (200 users per request), following graphs, public creator profiles, and 33 videos per call via clean REST JSON — no OAuth login, cookies, or residential proxies required.

→Unlike TikTok Display API or TikTok Studio (which require each creator to grant OAuth login), GET /v1/users/profile lets you fetch TikTok user data for any public @username immediately.
→GET /v1/users/profile returns user.id (immutable numeric user_id), user.secUid, bio signature, verified badge, and real-time followerCount, heartCount, and videoCount.

GET /v1/user/infoGET /v1/user/posts

Analytics & Python SDK · 20268 min read · Updated 2026-11-01

TikTok Analytics API & Python Guide: Creator Engagement, Video Velocity & Studio Metrics

How to build automated TikTok creator analytics, influencer vetting pipelines, and TikTok Studio metric dashboards in Python and TypeScript without per-user OAuth login.

→ByteDance's native TikTok Studio and Display APIs only expose analytics for accounts where the creator manually grants OAuth 2.0 permission — making competitor benchmarking and influencer discovery impossible.
→With ShortVid API, a single GET /v1/user/info + GET /v1/user/posts pipeline returns full engagement counters (play_count, digg_count, comment_count, share_count, collect_count) for any public creator at $0.20 per 1,000 videos.

GET /v1/user/infoGET /v1/user/posts

Creator Discovery · 20268 min read · Updated 2026-11-03

TikTok Influencer Search API: Find Creators by Niche & Follower Tier

How influencer marketing SaaS platforms and creator seeding teams automate TikTok creator discovery using GET /v1/user/search, /v1/user/info, and /v1/user/posts — without manual scrolling or enterprise Modash/HypeAuditor contracts.

→GET /v1/user/search lets you query TikTok creators by niche keyword with native server-side filters for follower tier (follower_count: 1=0–1K, 2=1K–10K, 3=10K–100K, 4=100K+) and verified status (profile_type=1).
→Creator search costs 1 Credit per returned creator ($0.10 per 1,000 creators at base rate, down to $0.04/1K on Business).

GET /v1/user/searchGET /v1/user/info

Lead Generation · 20267 min read · Updated 2026-11-03

How to Extract Creator Emails & Bio Leads from TikTok via API (Python & Node.js)

Turn TikTok creator search and follower graphs into a high-converting outbound sales and influencer seeding list — with production regex normalizers for obfuscated bio emails.

→Between 18% and 34% of mid-tier TikTok creators (10K–250K followers) publish a direct business inquiry email in their profile signature (e.g. 'mgmt@...', 'collab@...').
→By combining GET /v1/user/search (niche keyword discovery) and GET /v1/user/followers (lookalike audience harvesting from seed creators), you can generate thousands of targeted creator leads per hour.

GET /v1/user/searchGET /v1/user/info

Trend Intelligence · 20268 min read · Updated 2026-11-03

TikTok Hashtag, Sound & Viral Trends API: Track Breakout Topics in Real Time

How quantitative consumer funds, record labels, and social trend platforms detect breakout TikTok hashtags and audio tracks before they peak — using GET /v1/challenge/info, /v1/music/info, and /v1/feed/list.

→GET /v1/challenge/info resolves any hashtag name (without #) into its numeric challenge_id, total cumulative view_count, and total video user_count (10 Credits / call).
→GET /v1/challenge/posts and GET /v1/music/posts stream up to 30 tagged videos per call (2 Credits / video) complete with play_count, share_count, collect_count, and 1080p MP4 links.

GET /v1/challenge/infoGET /v1/challenge/posts

No-Code & AI Workflows · 20267 min read · Updated 2026-11-03

n8n & Make.com TikTok API Integration: Automate Video & Creator Workflows

Skip brittle browser scrapers and OAuth token expirations. Use a standard HTTP Request node in n8n or Make.com with your x-api-key header to automate TikTok monitoring, lead enrichment, and AI video pipelines.

→Every ShortVid API endpoint is a stateless HTTPS GET request authenticated via a single x-api-key header — making it 100% compatible with n8n's HTTP Request node, Make.com's HTTP module, and Zapier Webhooks.
→No OAuth refresh tokens, cookies, or proxy configuration required inside your workflow canvas.

GET /v1/video/searchGET /v1/user/posts

E-Commerce & Affiliates · 20268 min read · Updated 2026-11-03

TikTok Shop Affiliate & E-Commerce Product Intelligence via API

How DTC brands and TikTok Shop agencies identify top-performing affiliate creators, analyze product showcase videos, and benchmark competitor ad creatives using ShortVid API.

→Identify active TikTok Shop affiliate creators in any product category by querying GET /v1/video/search and GET /v1/challenge/posts for commerce hashtags (#tiktokshopfinds, #tiktokmademebuyit) and filtering for commerce-enabled posts.
→Benchmark paid e-commerce creatives with GET /v1/ads/top/ads filtered by country_code, period (7/30/180 days), and order_by=ctr or impression.

GET /v1/video/searchGET /v1/ads/top/ads

Official API Architecture · 20268 min read · Updated 2026-11-04

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

Everything engineering teams and data scientists need to know about ByteDance's Official TikTok Research API — who qualifies, what the 1,000-request daily quota covers, which fields are omitted, and how commercial teams map Research API queries to instant REST endpoints.

→The Official TikTok Research API is restricted to researchers employed by accredited non-profit academic institutions in the US, Europe, and select regions. For-profit companies, SaaS platforms, marketing agencies, and AI labs are ineligible.
→Approved academic projects receive a strict daily quota of 1,000 requests per day (up to 100 records per request) and must submit research proposals 4–8 weeks in advance.

Side-by-Side Feature & Pricing MatrixOAuth Scopes & Public Data Workaround

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.

→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.

GET /v1/user/infoGET /v1/user/posts

Python SDK & Asyncio Hub · 20269 min read · Updated 2026-11-04

Python TikTok API Tutorial (2026): requests, asyncio & Why Playwright Libraries Break

Stop debugging broken Playwright browser binaries, expired msToken cookies, and X-Bogus / X-Argus signature errors in open-source Python packages. Use standard Python requests or httpx.AsyncClient to query all 16 TikTok endpoints.

→Open-source PyPI packages like davidteather/TikTok-Api require local Chromium/Playwright instances, residential proxies, and manual msToken cookie extraction — and frequently break with EmptyResponseException or HTTP 403 when ByteDance rotates web signatures.
→With ShortVid API, your Python environment needs zero headless browsers: standard requests or httpx calls against https://api.shortvidapi.com/v1/* return clean JSON in 400–900ms.

WAF, JA3 & X-Bogus Deep DiveAll 16 Endpoints & Unit Costs

Scraper Architecture · $0.20/1K Videos8 min read · Updated 2026-11-04

TikTok Scraper API: Extract Public Videos, Profiles, Comments & Ads at Scale

Replace brittle headless browsers, residential proxy pools, and slow container queues with a synchronous REST TikTok Scraper API. Extract 1080p videos, creator profiles, 200-item follower lists, nested comments, and Creative Center commercial ads in sub-second JSON.

→Complete 16-endpoint coverage across 6 TikTok data domains: Videos, Users & Followers, Comments & Replies, Hashtags, Sounds/Music, and Creative Center Commercial Ads.
→Transparent per-item unit economics: $0.20 per 1,000 videos retrieved in batch/search, $0.10 per 1,000 comments or followers, and $1.00 per 1,000 commercial ads.

Latency & Cost BenchmarkUnit Economics Comparison

Ready to test with live TikTok data?

Create an account in 10 seconds and get 10,500 free Credits ($1.05) — no credit card required.

Claim 10,500 Free Credits ($1.05)Explore API Reference