# Douyin Post Comments API (https://www.socialcrawl.dev/platforms/douyin/post-comments)

> Returns top-level comments on a Douyin video: text, commenter, like count, reply count, the commenter's IP region, and whether the creator liked the comment. Top-level only. To read a thread call GET /v1/douyin/comment/replies with the comment ID from these rows.

TL;DR: `GET /v1/douyin/post/comments` costs 1 credit per call and returns SocialCrawl's unified JSON schema. Single x-api-key auth, 100 free credits on signup.

## Parameters

| Parameter | Required | Description |
| --- | --- | --- |
| `url` | yes | Douyin video URL or the bare numeric aweme ID. |
| `limit` | no | Comments to return, 1 to 100. Default 20. Each comment costs 1 credit and you are charged only for comments returned. |

## Code example

```bash
curl "https://www.socialcrawl.dev/v1/douyin/post/comments?url=https%3A%2F%2Fwww.douyin.com%2Fvideo%2F7681266289940544369" \
  -H "x-api-key: sc_YOUR_API_KEY"
```

## FAQ

### Are replies included?

No, this endpoint returns top-level comments only. Pass a comment ID with a non-zero reply count to the replies endpoint to open one thread, which keeps the parent link exact.

### What is the IP region on each comment?

Douyin shows the province a commenter posted from, which it displays publicly in the app. It is useful for reading regional sentiment differences within China.

### How many comments can I pull at once?

Up to 100 per call. Comments are the cheapest Douyin rows by a wide margin, so a deep read of one video's reaction is inexpensive compared with the other endpoints.

### Can I tell if the creator engaged with a comment?

Yes. Each comment records whether the video's creator liked it, which is a good signal for finding the exchanges the creator themselves considered worth acknowledging.

### What if a video has comments turned off?

You get an empty list and the credits are refunded. An empty upstream result is never billed, so probing a video that turns out to be locked costs nothing.

See the full Douyin API: https://www.socialcrawl.dev/platforms/douyin

## Pricing

- Standard endpoints: 1 credit per call
- Advanced endpoints: 5 credits per call
- Premium endpoints: 10 credits per call
- 100 free credits on signup, no credit card required. Cached responses cost 0 credits. Credit packs never expire.
- Full pricing: https://www.socialcrawl.dev/pricing

## Explore with AI

Questions this API answers, phrased for an AI assistant:

- how to scrape comments from a Douyin video
- how to analyse Chinese sentiment from Douyin comments