Douyin Fetch Home Feed
Retrieve the Douyin web home recommendation feed, either as a guest or personalized for an account. Inputs are optional and belong inside request_body: - count: Integer number of items requested. Defaults to 10; keeping this default is recommended. - refresh_index: Integer refresh/page index, default 0. Use 0 for the initial feed or a refresh. To load more, increment the index by 1 for each subsequent page. - cookie: Web Douyin login cookie, default empty. Provide it for that account's personalized recommendations; omit it for general guest recommendations. Returns a response object containing the feed payload in data, along with status and response metadata. The detailed fields within the feed payload are not specified.
Pricing
| Condition | Charge |
|---|---|
| Each call | 2.07 credits/call |
2.07 credits/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 | No | 获取抖音网页版首页推荐数据的请求体对象,可包含 count(请求数量)、refresh_index(刷新/翻页索引)和 cookie(用于账号个性化推荐的网页版登录 Cookie;不传则获取游客通用推荐)。 / Request body object for retrieving the Douyin web home recommendation feed, with optional count (number of items), refresh_index (refresh/paging index), and cookie (web login Cookie for account-personalized recommendations; omitted for a general guest feed). | — |
request_body.count | integer | No | 数量/Number | 10 |
request_body.cookie | string | No | 可选/Optional:用户网页版抖音登录Cookie,传入后返回该账号的个性化推荐;不传则以游客身份访问/Your web Douyin login Cookie for a personalized feed; guest access if omitted | "" |
request_body.refresh_index | integer | No | 刷新/翻页索引:0=刷新(首页/下拉),>0=翻页(下滑加载更多),每次+1取下一页 / Refresh-paging index: 0=refresh, >0=load-more, increment by 1 for next page | 0 |
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_home_feed' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"request_body": {
"count": 10,
"refresh_index": 0
}
}
}'{
"detail": {
"code": 400,
"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 提交给支持团队。本次请求不会被扣费。",
"request_id": "bf655af0-f05f-4e29-a8f4-08293f1ddd24"
}
}This example shows part of the response. Copied content is valid JSON.

