> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.beatapi.io/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.beatapi.io/_mcp/server.

# How do I fetch comments for a Douyin video ID?

> Call POST /v1/social-data/call with action douyin.app.v3.fetch_video_comments, string aweme_id, and integer cursor: 0 to retrieve the first batch of Douyin comments synchronously.

Fetch the first comment batch for a Douyin video by calling `POST /v1/social-data/call` with `action: "douyin.app.v3.fetch_video_comments"`, the video's post ID as a string `aweme_id`, and integer `cursor: 0`.

## First-page request

Replace `<aweme_id>` with the real Douyin post ID. The endpoint responds synchronously with the normalized BeatAPI envelope (`object`, `status`, `request_id`, `action`, and `data`).

```bash
curl -sS https://api.beatapi.io/v1/social-data/call \
  -H "Authorization: Bearer $BEATAPI_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"action":"douyin.app.v3.fetch_video_comments","params":{"aweme_id":"<aweme_id>","cursor":0}}'
```

Send an `Idempotency-Key` header if the client may retry timed-out calls; reusing an idempotency key with a different payload returns `409 idempotency_conflict`.

## Capture and triage the response

Read comment fields directly from the returned `data` object instead of assuming an undocumented output schema. Save the returned comments alongside the source video link and `request_id`. For example, when auditing a coffee-machine cleaning demo, log comments asking about cleaning steps with the batch's `request_id` first, then decide which threads require reply lookups or additional comment pages.

## Contracts and related questions

Before running the request, inspect the `data:douyin.app.v3.fetch_video_comments` contract for free.

[Back to Douyin questions](/faq/douyin).