Extract Post

POST/openapi/v1/extract/post — 1 credit per successful call.

Supports 1,000+ sites — the most common ones are listed under "Supported sites" below.

curl -X POST https://api.snapany.com/openapi/v1/extract/post \
  -H "Authorization: Bearer sk_snapany_xxx" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://x.com/user/status/123456"}'

What the response contains at a glance (fields a site does not provide are omitted):

Post: title/text, publish time, canonical URL, stats (views / likes / comments / shares)
Author: display name, avatar, follower count, verification status
medias: a directly downloadable URL for every video / image / audio, with cover image and duration
variants: quality/format tiers for videos (resolution, codec, fps, file size, separate audio track), language variants for multi-audio content
subtitles: direct subtitle URLs in multiple languages and formats (srt / vtt and more)
headers: request headers some sites require for downloading

Full schema and a real-shaped response example: API Reference.

Notes:

Media direct URLs are typically short-lived (hours) — download promptly rather than storing the URLs.
Business failures (deleted/private content, unsupported URL) return HTTP 400 with an error code and are not charged.

Downloading the media

Send the returned headers: when a media carries a headers object, send every header as-is when downloading — otherwise you may get HTTP 403. An empty string value is intentional (e.g. an empty User-Agent) and must still be sent.

import requests

media = post["medias"][0]
response = requests.get(media["resource_url"], headers=media.get("headers") or {}, stream=True)
with open("video.mp4", "wb") as f:
    for chunk in response.iter_content(1 << 20):
        f.write(chunk)

Pick a quality variant: video variants are sorted by quality (resolution height; 9999 means original quality and sorts first). Pick the closest tier at or below your target:

const variants = media.variants ?? []
const target = 1080
const pick = variants.filter(v => v.quality <= target).sort((a, b) => b.quality - a.quality)[0] ?? variants.at(-1)

Merge separate audio/video streams: when a variant has both video_url and audio_url, they are separate streams. Download both, then merge with ffmpeg — stream copy, no re-encode, takes seconds. If only one URL is present, it is already a complete file.

ffmpeg -i video.mp4 -i audio.m4a -c copy merged.mp4

Supported sites

YouTube, TikTok, Instagram, X/Twitter, Facebook, Threads, Reddit, Pinterest, Tumblr, Vimeo, Dailymotion, VK, OK.ru, Twitch, Likee, Kwai, Suno, Sora, bilibili.tv, Xiaohongshu (RED), Bilibili, Weibo, WeChat official accounts & Channels, Toutiao / Xigua Video, Haokan Video, Tencent Video, iQIYI, Migu Video, Sohu Video, CCTV, NetEase Cloud Music, Qishui Music, WeSing, Weishi, AcFun, Huoshan, Pipixia, Pipi Gaoxiao, Zuiyou, Pear Video, Hongguo Duanju, Jianying (CapCut CN), Jimeng, Doubao, Meipai, Meitu, Momo, Inke, Yinyuetai, Qutoutiao, Xiaoying (VivaVideo), Dewu, and 1,000+ more sites.

Full request/response schema: API Reference.