Xiaohongshu Fetch Homefeed
Retrieve Xiaohongshu homepage recommended notes, optionally by category channel and with image-and-text notes only. Inputs (all optional): - num: Number of notes requested; defaults to 20, maximum 40. - category: Category channel ID; defaults to "homefeed_recommend". Use a channel ID, not a search keyword. - cursor_score: Pagination cursor; leave empty for the first page. Defaults to "". - need_filter_image: Set to true for image-and-text notes only, or false for mixed recommendations including videos. Defaults to false. Returns response data containing the recommended notes. The available schema does not specify individual note fields or pagination response fields.
Pricing
| Condition | Charge |
|---|---|
| Each call | 20.65 credits/call |
20.65 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 |
|---|---|---|---|---|
num | integer | No | 返回数量,最大40/Number of results, max 40 | 20 |
category | string | No | 分类频道ID/Category channel ID | homefeed_recommend |
cursor_score | string | No | 翻页游标/Pagination cursor | "" |
need_filter_image | boolean | No | 仅图文/Image notes only | false |
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_xiaohongshu_fetch_homefeed' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"num": 20
}
}'{
"code": 200,
"data": {
"code": 0,
"data": {
"cursor_score": "seo_homefeed_20261108_19",
"items": [
{
"id": "692bf443000000001e006155",
"ignore": false,
"model_type": "note",
"note_card": {
"cover": {},
"display_title": "盘点那些疯狂动物城音乐系列🐰🦊🎧",
"interact_info": {},
"type": "video",
"user": {},
"video": {}
},
"xsec_token": "ABx0b_ajVjwnsjDg51lGvH7Bhje8bQqY4425eAVUaKJ_c="
}
]
},
"msg": "成功",
"ok": true,
"status": 200,
"success": true
},
"docs": "https://api.tikhub.io/#/Xiaohongshu-Web-V3-API/fetch_homefeed_api_v1_xiaohongshu_web_v3_fetch_homefeed_get",
"message": "Request successful. This request will incur a charge.",
"message_zh": "请求成功,本次请求将被计费。",
"request_id": "f731dfd7-299d-4273-bb71-343083f7463f"
}This example shows part of the response. Copied content is valid JSON.

