> **For coding agents and LLMs:** This is one Social Fetch marketing page (markdown export). For API orientation start with [`/llms.txt`](https://www.socialfetch.dev/llms.txt); for auth and crawl rules use [`/agents.txt`](https://www.socialfetch.dev/agents.txt); for every operation use [`/llms-endpoints.txt`](https://www.socialfetch.dev/llms-endpoints.txt).

## This page

- **On-site (HTML):** <https://www.socialfetch.dev/platforms/douyin/videos-comments>
- **Markdown (.mdx) URL:** <https://www.socialfetch.dev/platforms/douyin/videos-comments.mdx>

---

# Douyin Comments API

A video's comments as structured JSON, a page at a time.

`GET /v1/douyin/videos/comments?url=https://www.douyin.com/video/7687419490820295970` returns `data.comments`, 20 a page in Douyin's order: text, `createdAt`, likes, `replyCount`, `ipLocation`, photos, `likedByCreator`, `isPinned` and the commenter. `totalComments` is Douyin's count for the video.

Pass `page.nextCursor` back as `cursor` while `page.hasMore` is true. Each comment appears once across pages, even where Douyin lists a popular comment again further down. A video that does not exist returns `lookupStatus: not_found`.

## Request

- **Endpoint:** `GET /v1/douyin/videos/comments`
- **Credits:** 1 credit
Failed requests are free
Found, empty and not-found answers are all charged
- **Input:** by video URL
- **Full reference:** [docs](https://www.socialfetch.dev/docs/api/v1/douyin/videos/comments/get)
- **Platform page:** [/platforms/douyin](https://www.socialfetch.dev/platforms/douyin)

## FAQ

### How do I get the next page?

Pass page.nextCursor from the previous response as cursor. It only works with the same video.

### Can a page have fewer than 20 comments?

Yes. Douyin repeats popular comments from the first page further down; those are left out, so a later page can be shorter.

### Are replies included?

No. Each comment carries its replyCount; Douyin keeps replies behind sign-in.

### How many credits does a comments page cost?

Pricing is documented on the operation in the API registry (shown on this page). Confirm on every response with meta.creditsCharged: that field is the billing source of truth.
