Douyin Search Douplus Video
## Purpose Search Douyin DOU+ videos by title or keyword, with cursor-based pagination. ## Inputs Provide a required `request_body` object containing: - `keyword` (required string): Video title or search keyword. - `cursor` (optional integer or null): Pagination cursor; defaults to `0` for the first page. For subsequent pages, use the cursor returned by the previous response. - `count` (optional integer or null): Page size; defaults to `12`. - `cookie` (optional string or null): The user's `www.douyin.com` web Cookie. ## Results Returns a response containing status information and a data payload for matching videos and pagination information. The nested video and pagination fields are not formally specified; inspect the returned data before using them.
Pricing
| Condition | Charge |
|---|---|
| Each call | 2.07 credits/call |
A fixed charge of 2.07 credits applies per call. Charges are per query. A successful query is billed even if it returns no results.
Parameters
Optional parameters use the platform defaults when omitted.
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
request_body | object | Yes | 按标题或关键词搜索 DOU+ 视频的请求体对象:keyword 为必填的视频标题或关键词;cursor 为翻页游标,首页传 0,后续传上一页响应中的 cursor;count 为每页数量,默认 12;cookie 为用户 www.douyin.com 网页版 Cookie。 | — |
request_body.count | integer | null | No | 每页数量/Page size | 12 |
request_body.cookie | string | null | No | 用户 www.douyin.com 网页版 Cookie/User www.douyin.com web Cookie | — |
request_body.cursor | integer | null | No | 翻页游标,首页传 0,后续传上一页响应里的 cursor/Pagination cursor, 0 for first page | 0 |
request_body.keyword | string | Yes | 视频标题/关键词/Video title or keyword | — |
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_search_douplus_video' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"request_body": {
"count": 18,
"cursor": 0,
"keyword": "宠物羊奶粉"
}
}
}'{
"detail": {
"code": 400,
"docs": "https://api.tikhub.io/#/Douyin-DouPlus-API/search_video_api_v1_douyin_douplus_search_video_post",
"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": {}
}
}This example shows part of the response. Copied content is valid JSON.

