Get Douyin video
Get a Douyin video or photo post by URL, with its caption, hashtags, counts, sound, cover and file.
Headers
Get your API keyAPI key (`sfk_...`)
Link to the Douyin video or photo post, as in https://www.douyin.com/video/7687419490820295970. A share link, a v.douyin.com short link or the numeric id also works.
min 1 chars · max 1024 chars
Endpoint-specific response payload.
`not_found` when no public video has this id: deleted, made private, or never existed.
one of: found, not_found
The video when `lookupStatus` is `found`; otherwise null.
Douyin video id (`aweme_id`), the same on every endpoint.
Video page (or photo post page).
`images` for a photo post, `video` otherwise.
one of: video, images
Caption as plain text.
The title the creator set, when it differs from the caption.
Hashtags in the caption, without the `#`.
When it was posted, ISO 8601 UTC.
Length in seconds, to the millisecond; null for a photo post.
Width in pixels.
Height in pixels.
Cover image. Signed; it expires.
The MP4 file. A signed link that expires after a few hours: download it, do not store it.
The photos of a photo post; empty for a video.
Image URL. Signed; it expires.
Width in pixels.
Height in pixels.
Engagement counters as Douyin reports them.
Views. Douyin hides the view count from logged-out visitors on most videos, so this is usually null.
Likes.
Comments.
Shares.
Times saved to favourites.
The sound the video uses.
Douyin sound id.
The sound's title.
Who made the sound.
True when the creator pinned it to the top of the profile.
True for a paid promotion.
The creator.
Douyin's numeric user id (`uid`), the same on every endpoint.
Douyin's public user id, as in douyin.com/user/{secUid}. Pass it to the profile endpoints.
Douyin id (抖音号) shown on the profile, when set.
Display name.
Profile picture.
True when Douyin verified the account.
Profile page.
Metadata describing the request and billing outcome.
Unique request identifier for tracing this API call.
min 1 chars
Credits charged for this request.
≥ 0
Public API version that served the response.
one of: v1
Present, and `true`, only when the source couldn't be reached and this is the last good answer for the same request instead, up to 24 hours old. Absent on every live answer.
one of: true
When a stale answer (`stale: true`) was originally fetched (ISO 8601, UTC). Absent on every live answer.
Code example
curl "https://api.socialfetch.dev/v1/douyin/videos?url=https://www.douyin.com/video/7687419490820295970" \
-H "x-api-key: YOUR_API_KEY"Responses
A Douyin video or photo post.