Do I increment cursor for the next page?
No. Never increment cursor manually by 1. For every subsequent page on douyin.app.v3.fetch_video_comments, pass the exact cursor value returned by the previous response unchanged while keeping the same video aweme_id.
Chain pages cleanly
- Start the first call to
POST /v1/social-data/callwithaweme_idas a string andcursor: 0. - Read the returned cursor directly from the live response payload, pass the returned value unchanged as
cursoron the next call for the sameaweme_id, and save each page as a separate file. - For example, when page 1 reveals installation questions and a broader sample across other product models is needed, request page 2 with page 1’s returned cursor rather than guessing the next integer.
Stop conditions and failure handling
Stop paginating immediately when any of four conditions occurs:
- The planned page cap is reached.
- The response omits a cursor or repeats an earlier cursor.
- The returned batch contains zero comments.
- A page request fails.
Record the exact number of pages fetched in the final notes. When a later page fails, failed calls do not consume credits; store the failed page’s parameters and request_id for follow-up while continuing review on the pages already saved.
Contracts and related questions
Before running the request, inspect the data:douyin.app.v3.fetch_video_comments contract for free.

