SocialPipe docs

Xiaohongshu Web V3 Fetch Homefeed

GET/v1/xiaohongshu/web_v3/fetch_homefeed

Returns personal data about people in bulk. The response carries accounts who are not the subject of your request. See our terms for what you may do with it.

Costs 10 credits. A cache hit costs nothing, and an answer that contains no data is never charged.

curl "https://api.socialpipe.dev/v1/xiaohongshu/web_v3/fetch_homefeed" \  -H "Authorization: Bearer $SOCIALPIPE_KEY"
AuthorizationBearer <token>

Your SocialPipe API key, as Authorization: Bearer sp_live_…. Create one in the dashboard.

In: header

Query Parameters

num?|

40/Number of results, max 40

cursor_score?|

Pagination cursor

category?|

ID/Category channel ID

need_filter_image?|

Image notes only

cache_ttl?|

Max acceptable age of a cached result, in seconds. A lower value demands fresher data; it does not shorten what is stored.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v1/xiaohongshu/web_v3/fetch_homefeed"
{  "cache_age": 0,  "cached": false,  "credits_remaining": 0,  "credits_used": 0,  "data": {},  "schema_version": "2",  "success": true,  "took_ms": 0}