# 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 comment RETURNED, with a floor of 2. The call holds `limit x 1` up front - the default limit of 20 holds 20 and the 100 maximum holds 100 - and settles down to the comments actually delivered, so a video with four comments does not cost a twenty-comment request 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. |
| `since` | no | Only rows published on or after this date: YYYY-MM-DD (midnight UTC) or an ISO 8601 timestamp. Rows older than it are left off each page. This list is not in date order, so the walk does not stop at the date: keep following `next_cursor`, and each page costs what a page costs even when every row on it is filtered out. A row with no date is kept. `published_after`, `start_date`, `from_date`, `publish_time` (`yesterday`, `this-week`, `this-month`, `last-3-months`, `last-6-months`) and `max_age_days` are accepted and applied as `since`. |
| `until` | no | Only rows published on or before this date: YYYY-MM-DD (that whole UTC day is included) or an ISO 8601 timestamp. Newer rows are left off each page and the walk does not stop, so older pages follow. A row with no date is kept. `published_before`, `end_date` and `to_date` are accepted and applied as `until`. |

## Code example

```bash
curl -G "https://www.socialcrawl.dev/v1/douyin/post/comments" \
  --data-urlencode "url=https://www.douyin.com/video/7681266289940544369" \
  -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