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…
Headers
Get your API keyAPI key (`sfk_...`)
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
Endpoint-specific response payload.
`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`.
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.
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.
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.
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.
Whether another page is available.
Cursor to pass in the next request when more pages exist; null on the last 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/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.