Douyin

List Douyin video comments

List a Douyin video's comments, 20 a page with a cursor, with likes, replies and IP location.

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

API key (`sfk_...`)

Parameters
2
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

cursorstringoptionalquery

Pass `page.nextCursor` from the previous response to get the next page. It only works with the same video.

min 1 chars · max 4096 chars

Response fields
34

Endpoint-specific response payload.

datalookupStatus
string

`not_found` when no public video has this id.

one of: found, not_found

datavideoId
string

The video's id.

datatotalComments
integernullable

Comments on the video, as Douyin counts them.

Top-level comments, about 20 a page, in Douyin's order.

datacomments[]id
string

Douyin comment id.

datacomments[]text
string

Comment text.

datacomments[]createdAt
stringnullable

When it was written, ISO 8601 UTC.

datacomments[]likes
integernullable

Likes on the comment.

datacomments[]replyCount
integernullable

Replies to the comment.

datacomments[]ipLocation
stringnullable

The province or country Douyin shows as the writer's IP location.

datacomments[]likedByCreator
booleannullable

True when the video's creator liked the comment.

datacomments[]isPinned
booleannullable

True when the creator pinned the comment.

Photos attached to the comment; empty for text-only comments.

datacomments[]images[]url
string

Image URL. Signed; it expires.

datacomments[]images[]width
integernullable

Width in pixels.

datacomments[]images[]height
integernullable

Height in pixels.

Who wrote it.

datacomments[]authorid
stringnullable

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

datacomments[]authorsecUid
stringnullable

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

datacomments[]authorhandle
stringnullable

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

datacomments[]authordisplayName
stringnullable

Display name.

datacomments[]authoravatarUrl
stringnullable

Profile picture.

datacomments[]authorisVerified
booleannullable

True when Douyin verified the account.

datacomments[]authorurl
stringnullable

Profile page.

Pagination state for the current page.

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/videos/comments?url=https://www.douyin.com/video/7687419490820295970" \
  -H "x-api-key: YOUR_API_KEY"

Responses

A page of a Douyin video's comments.