Xiaohongshu Fetch Homefeed

20.65 credits/call
ae_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.

Social
20.65 credits/call

Pricing

20.65 credits/call
ConditionCharge
Each call20.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.

ParameterTypeRequiredDescriptionDefault
numintegerNo返回数量,最大40/Number of results, max 4020
categorystringNo分类频道ID/Category channel IDhomefeed_recommend
cursor_scorestringNo翻页游标/Pagination cursor""
need_filter_imagebooleanNo仅图文/Image notes onlyfalse

Invocation example

Copy the request and explore its response example.

POST/agent-api/v1/tool/executeX-Api-Key
Request coderequest.sh
curl --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
  }
}'
Response exampleresponse.json
JSONPartial content
{
  "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.