Douyin

List Douyin profile videos

List the videos Douyin shows signed-out visitors on a creator's page, about 20, with captions, counts, covers and files. The list can lag the creator's newest…

GET/v1/douyin/profiles/{secUid}/videos
x-api-keystringheader

API key (`sfk_...`)

Parameters
1
secUidstringrequiredpath

Douyin's public user id from the profile link, as in douyin.com/user/{secUid}, for example `MS4wLjABAAAA5LE5fb8MvFq4oU8t-ZA4ENG2fLsaSUvkWu16F9MeGkw`. A full profile link or a v.douyin.com short link also works.

min 1 chars · max 512 chars

Response fields
59

Endpoint-specific response payload.

datalookupStatus
string

`private` when the account is private: Douyin shows logged-out visitors none of its videos, so the list is empty. `not_found` when no account has this id.

one of: found, private, not_found

The account, when the answer names it; null when `not_found`.

dataprofileid
stringnullable

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

dataprofilesecUid
stringnullable

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

dataprofilehandle
stringnullable

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

dataprofiledisplayName
stringnullable

Display name.

dataprofileavatarUrl
stringnullable

Profile picture.

dataprofileisVerified
booleannullable

True when Douyin verified the account.

dataprofileurl
stringnullable

Profile page.

dataprofileisBanned
booleannullable

True when Douyin banned the account. Douyin then shows no videos, so the list is empty.

The videos Douyin shows signed-out visitors on the creator's page, about 20, newest first with pinned videos first. Douyin's signed-out list can lag the creator's newest posts by several days.

datavideos[]id
string

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

datavideos[]url
string

Video page (or photo post page).

datavideos[]mediaType
string

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

one of: video, images

datavideos[]caption
stringnullable

Caption as plain text.

datavideos[]title
stringnullable

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

Hashtags in the caption, without the `#`.

datavideos[]hashtags[]
stringoptional
datavideos[]createdAt
stringnullable

When it was posted, ISO 8601 UTC.

datavideos[]durationSeconds
numbernullable

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

datavideos[]width
integernullable

Width in pixels.

datavideos[]height
integernullable

Height in pixels.

datavideos[]coverUrl
stringnullable

Cover image. Signed; it expires.

datavideos[]videoUrl
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.

datavideos[]images[]url
string

Image URL. Signed; it expires.

datavideos[]images[]width
integernullable

Width in pixels.

datavideos[]images[]height
integernullable

Height in pixels.

Engagement counters as Douyin reports them.

datavideos[]statsviews
integernullable

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

datavideos[]statslikes
integernullable

Likes.

datavideos[]statscomments
integernullable

Comments.

datavideos[]statsshares
integernullable

Shares.

datavideos[]statssaves
integernullable

Times saved to favourites.

The sound the video uses.

datavideos[]soundid
stringnullable

Douyin sound id.

datavideos[]soundtitle
stringnullable

The sound's title.

datavideos[]soundauthor
stringnullable

Who made the sound.

datavideos[]isPinned
booleannullable

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

datavideos[]isAd
booleannullable

True for a paid promotion.

The creator.

datavideos[]authorid
stringnullable

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

datavideos[]authorsecUid
stringnullable

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

datavideos[]authorhandle
stringnullable

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

datavideos[]authordisplayName
stringnullable

Display name.

datavideos[]authoravatarUrl
stringnullable

Profile picture.

datavideos[]authorisVerified
booleannullable

True when Douyin verified the account.

datavideos[]authorurl
stringnullable

Profile page.

datatruncated
boolean

True when the creator has more videos than these. Douyin shows signed-out visitors one page, so the list stops there.

Always the last page: Douyin shows logged-out visitors one page of a creator's videos. `truncated` says whether there are more.

datapagehasMore
boolean

Whether another page is available.

datapagenextCursor
stringnullable

Cursor to pass in the next request when more pages exist; null on the last 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/profiles/MS4wLjABAAAA5LE5fb8MvFq4oU8t-ZA4ENG2fLsaSUvkWu16F9MeGkw/videos" \
  -H "x-api-key: YOUR_API_KEY"

Responses

The videos Douyin shows signed-out visitors on a creator's page, which can lag their newest posts by days.