Douyin

Get Douyin video

Get a Douyin video or photo post by URL, with its caption, hashtags, counts, sound, cover and file.

GET/v1/douyin/videos
x-api-keystringheader

API key (`sfk_...`)

Parameters
1
urlstringrequiredquery

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

Response fields
46

Endpoint-specific response payload.

datalookupStatus
string

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

datavideoid
string

Douyin video id (`aweme_id`), the same on every endpoint.

datavideourl
string

Video page (or photo post page).

datavideomediaType
string

`images` for a photo post, `video` otherwise.

one of: video, images

datavideocaption
stringnullable

Caption as plain text.

datavideotitle
stringnullable

The title the creator set, when it differs from the caption.

Hashtags in the caption, without the `#`.

datavideohashtags[]
stringoptional
datavideocreatedAt
stringnullable

When it was posted, ISO 8601 UTC.

datavideodurationSeconds
numbernullable

Length in seconds, to the millisecond; null for a photo post.

datavideowidth
integernullable

Width in pixels.

datavideoheight
integernullable

Height in pixels.

datavideocoverUrl
stringnullable

Cover image. Signed; it expires.

datavideovideoUrl
stringnullable

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.

datavideoimages[]url
string

Image URL. Signed; it expires.

datavideoimages[]width
integernullable

Width in pixels.

datavideoimages[]height
integernullable

Height in pixels.

Engagement counters as Douyin reports them.

datavideostatsviews
integernullable

Views. Douyin hides the view count from logged-out visitors on most videos, so this is usually null.

datavideostatslikes
integernullable

Likes.

datavideostatscomments
integernullable

Comments.

datavideostatsshares
integernullable

Shares.

datavideostatssaves
integernullable

Times saved to favourites.

The sound the video uses.

datavideosoundid
stringnullable

Douyin sound id.

datavideosoundtitle
stringnullable

The sound's title.

datavideosoundauthor
stringnullable

Who made the sound.

datavideoisPinned
booleannullable

True when the creator pinned it to the top of the profile.

datavideoisAd
booleannullable

True for a paid promotion.

The creator.

datavideoauthorid
stringnullable

Douyin's numeric user id (`uid`), the same on every endpoint.

datavideoauthorsecUid
stringnullable

Douyin's public user id, as in douyin.com/user/{secUid}. Pass it to the profile endpoints.

datavideoauthorhandle
stringnullable

Douyin id (抖音号) shown on the profile, when set.

datavideoauthordisplayName
stringnullable

Display name.

datavideoauthoravatarUrl
stringnullable

Profile picture.

datavideoauthorisVerified
booleannullable

True when Douyin verified the account.

datavideoauthorurl
stringnullable

Profile page.

Metadata describing the request and billing outcome.

metarequestId
string

Unique request identifier for tracing this API call.

min 1 chars

metacreditsCharged
integer

Credits charged for this request.

≥ 0

metaversion
string

Public API version that served the response.

one of: v1

metastale
booleanoptional

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

metafetchedAt
stringoptional

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.