B2B Media Ingestion Infrastructure · GET /v1/video/detail?hd=1 · REST & Base x402
TikTok Video Downloader API — 1080p HD MP4, Carousels & JSON
Production REST API built for AI video clipping SaaS, UGC creative archives, Whisper ASR pipelines, and social listening platforms. Resolve direct official CDN 1080p MP4 streams (data.hdplay), Photo Mode image carousels (data.images[]), audio tracks, and full engagement counters in a single sub-second GET call — from $9 Pay-As-You-Go or $0.001 Base Mainnet USDC (x402).
01 · $9 Never-Expiring PAYG
75,000 Credits (7,500 single 1080p post resolutions or 37,500 feed videos) at 120 RPM — zero monthly lock-in.
02 · Keyless $0.001 USDC x402
Autonomous AI agents and scripts can pay $0.001 Base Mainnet USDC per call with zero registration or API keys ($0 settled on errors).
03 · 1080p MP4 + Photo Slides
Handles desktop links, vm.tiktok.com short links, 1080p hdplay, 720p play, multi-slide carousels, and soundtrack MP3 URLs.
04 · 10,500 Free Credits ($1.05)
Instant live API key on signup — no credit card, no TikTok cookies, and no residential proxy pools to maintain.
Quickstart & Live Payload
One GET request — 4 integration paths (REST & x402)
Call GET /v1/video/detail?url=...&hd=1 (or GET /v1/videos/detail) with a standard x-api-key or Base Mainnet USDC PAYMENT-SIGNATURE header.
import requests
API_KEY = "tk_live_your_api_key_here"
POST_URL = "https://www.tiktok.com/@tiktok/video/7106594312292453675"
resp = requests.get(
"https://api.shortvidapi.com/v1/video/detail",
params={"url": POST_URL, "hd": 1},
headers={"x-api-key": API_KEY},
timeout=15,
)
resp.raise_for_status()
data = resp.json()["data"]
# Direct official TikTok CDN URLs (0 proxy hops):
print("1080p MP4:", data["hdplay"])
print("720p MP4:", data["play"])
print("Photo Slides:", data.get("images") or [])
print("Audio Stream:", data["music_info"]["play"]){
"code": 0,
"provider": "https://shortvidapi.com",
"status": "ok",
"msg": "success",
"data": {
"id": "7106594312292453675",
"region": "US",
"title": "One TikTok can make a big impact #TikTok",
"duration": 15,
"play": "https://v16-webapp-prime.tiktok.com/video/tos/alisg/tos-alisg-pve-0037c001/direct-720p.mp4",
"hdplay": "https://v16-webapp-prime.tiktok.com/video/tos/alisg/tos-alisg-pve-0037c001/direct-1080p-hd.mp4",
"size": 2841920,
"hd_size": 5918240,
"images": [],
"play_count": 4820900,
"digg_count": 391200,
"comment_count": 8420,
"share_count": 19500,
"collect_count": 44100,
"music_info": {
"id": "7106594322274962182",
"title": "original sound - TikTok",
"author": "TikTok",
"duration": 15,
"play": "https://sf16-ies-music-va.tiktokcdn.com/obj/musically-maliva-obj/7106594322274962182.mp3"
},
"author": {
"id": "107955",
"unique_id": "tiktok",
"nickname": "TikTok"
}
}
}Architecture Comparison
Why engineering teams replace yt-dlp & headless browsers
| Capability | ShortVid API (/v1/video/detail) | DIY yt-dlp + Residential Proxies | Official TikTok Display API |
|---|---|---|---|
| Any Public TikTok URL | Yes — zero OAuth or creator login | Breaks on HTTP 403 / signature updates | No — requires per-user OAuth 2.0 token |
| 1080p HD + Photo Carousels | data.hdplay + data.images[] + audio | Fragile Photo Mode & short-link support | Expiring embed/scoped links only |
| Median Latency | ~650–900ms synchronous JSON | 4–15s process spawn + proxy handshake | ~500ms (authenticated owner only) |
| Unit Economics | $1.00/1K single lookups ($0.20/1K on feeds) · $0 on errors | $3.00–$10.00/1K in residential proxy GB + devops | Strict app review & rate quotas |
| Autonomous Agent Payment | Native Base Mainnet USDC x402 ($0.001/call) | Not supported | Not supported |
AI Video Clipping & Repurposing SaaS
Ingest 1080p source streams directly from TikTok share links into FFmpeg, Remotion, or GPU scene-detection workers without datacenter 403 blocks.
UGC Creative Archiving & Brand Safety
Automatically archive sponsored creator posts, Photo Mode slides, audio tracks, and live view/save metrics for e-commerce campaign reporting.
Multimodal LLM & Whisper ASR Pipelines
Pull lightweight audio streams (data.music_info.play) and 720p video URLs at $0.20/1K feed items for speech-to-text and visual hook indexing.
Frequently Asked Questions
How much does it cost to resolve 1080p TikTok MP4 streams via ShortVid API?
Single-post resolution (GET /v1/video/detail?hd=1) costs a flat 10 Credits ($0.001 base, or $1.00 per 1,000 single-post lookups, dropping to $0.60/1K on Business Monthly). Batch creator feeds (GET /v1/user/posts) and keyword search (GET /v1/video/search) also return direct MP4 URLs at just $0.20 per 1,000 videos. You can start with 10,500 Free Credits ($1.05, no card), buy a never-expiring $9 Pay-As-You-Go pack (75,000 Credits), or pay $0.001 USDC per call with zero signup via Base Mainnet x402.
Why do DIY yt-dlp and headless Playwright workers break on AWS, GCP, and Hetzner?
TikTok blocks datacenter ASN IP ranges with HTTP 403 Forbidden and rotates device signatures and short-link redirects frequently. Maintaining residential proxies and headless Chromium instances typically costs $3–$10 per 1,000 videos in proxy bandwidth and compute. ShortVid API handles link normalization, signing, and region routing behind a single <900ms HTTPS GET endpoint.
Does the endpoint support TikTok Photo Mode carousels and vm.tiktok.com mobile short links?
Yes. Pass any desktop URL, vm.tiktok.com / vt.tiktok.com short share link, or 19-digit numeric ID without pre-resolving redirects. For Photo Mode posts, data.images[] returns the ordered list of high-resolution slide image URLs alongside data.music_info.play.
Does ShortVid API host media files or access private accounts?
No. ShortVid API strictly resolves metadata and direct CDN links for public TikTok posts only — 0 bytes of video, image, or audio are proxied or stored by our gateway. Private, deleted, or region-locked items return 404 and charge 0 credits.
Compliance & Copyright Notice: ShortVid API resolves public metadata and direct links hosted on TikTok's official CDN — 0 bytes of media files are proxied, hosted, or stored by ShortVid API, and private/deleted posts are never accessible. Customers are responsible for processing only content they own or are authorized to analyze. Copyright & takedown contact: support@shortvidapi.com.
Start resolving 1080p streams in under 30 seconds.
Claim 10,500 free sandbox credits on signup, top up from $9 Pay-As-You-Go (Stripe Card, Apple Pay, Google Pay, or 0%-fee Crypto), or call keyless with Base USDC x402.