Skip to content
ShortVid API

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"])
200 OK · Standardized JSON Schema10 Credits ($0.001)
{
  "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

CapabilityShortVid API (/v1/video/detail)DIY yt-dlp + Residential ProxiesOfficial TikTok Display API
Any Public TikTok URLYes — zero OAuth or creator loginBreaks on HTTP 403 / signature updatesNo — requires per-user OAuth 2.0 token
1080p HD + Photo Carouselsdata.hdplay + data.images[] + audioFragile Photo Mode & short-link supportExpiring embed/scoped links only
Median Latency~650–900ms synchronous JSON4–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 + devopsStrict app review & rate quotas
Autonomous Agent PaymentNative Base Mainnet USDC x402 ($0.001/call)Not supportedNot 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.