Douyin Fetch Series Video List
## Purpose List episode videos for a specified Douyin short-drama series, with pagination. ## Inputs - **series_id** (required string): The short-drama series ID. - **cursor** (optional integer, default `0`): Pagination cursor. Use `0` for the first page; use the appropriate cursor for subsequent pages. No page-size input is exposed. ## Result Returns series video-list data. `aweme_list` contains episode video information, and `has_more` indicates whether more data is available. A response may cover only one page, not every episode in the series. ## Example `series_id="7592054624643713067", cursor=0`
Pricing
| Condition | Charge |
|---|---|
| Each call | 2.07 credits/call |
The fixed fee is 2.07 credits per call. Charges are per query. A successful query is billed even if it returns no results.
Each pagination call is charged separately. A single response may contain only one page; retrieving subsequent pages requires additional calls when more data is available.
Parameters
Optional parameters use the platform defaults when omitted.
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
cursor | integer | No | 游标/Cursor | 0 |
series_id | string | Yes | 短剧id/Series id | — |
Invocation example
Copy the request and explore its response example.
/agent-api/v1/tool/executeX-Api-Keycurl --request POST \
--url 'https://agentearth.ai/agent-api/v1/tool/execute?tool_name=ae_douyin_fetch_series_video_list' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"cursor": 0,
"series_id": "7696390434951530506"
}
}'{
"detail": {
"code": 400,
"docs": "https://api.tikhub.io/#/Douyin-App-V3-API/fetch_series_video_list_api_v1_douyin_app_v3_fetch_series_video_list_get",
"headers": {},
"message": "Request failed. Please retry. Check the docs below to verify your parameters, test with the default demo parameters, and send the response JSON to support. You won't be charged for this request.",
"message_zh": "请求失败,请重试。请查看下方文档核对参数,使用默认演示参数测试,并将响应 JSON 提交给支持团队。本次请求不会被扣费。",
"params": {
"cursor": "0",
"series_id": "7696390434951530506"
}
}
}This example shows part of the response. Copied content is valid JSON.

