# Social Fetch API - Xiaohongshu endpoints # Base URL: https://api.socialfetch.dev # Auth: x-api-key header (sfk_...) # Full catalog: https://www.socialfetch.dev/llms-endpoints.txt | JSON: https://www.socialfetch.dev/llms.json # Docs hub: https://www.socialfetch.dev/docs/api | OpenAPI: https://www.socialfetch.dev/openapi.json 4 documented Xiaohongshu operations. Do not invent paths - only the routes below (and their linked markdown pages) are supported. ## GET /v1/xiaohongshu/profiles/{profileId} Get Xiaohongshu profile Credit cost: 1 credit. Failed requests are free. Found, empty and not-found answers are all charged. Auth: API key or x402 payment (no key needed for payment) Docs: https://www.socialfetch.dev/docs/api/v1/xiaohongshu/profiles/profileid/get.mdx SDK: client.xiaohongshu.getProfile({ profileId: "5c4a8f94000000001003f8c1" }) Parameters: - profileId (required, string) - The creator's profile id (Xiaohongshu's user id), the 24 characters after `/user/profile/` in a profile link, for example `5c4a8f94000000001003f8c1`. A whole profile link, or the app's `xhslink.com` share link, also works. Outcome field: `data.lookupStatus` in `found`, `not_found` curl "https://api.socialfetch.dev/v1/xiaohongshu/profiles/5c4a8f94000000001003f8c1" \ -H "x-api-key: YOUR_API_KEY" ## GET /v1/xiaohongshu/profiles/{profileId}/notes List Xiaohongshu profile notes Credit cost: 1 credit. Failed requests are free. Found, empty and not-found answers are all charged. Auth: API key or x402 payment (no key needed for payment) Docs: https://www.socialfetch.dev/docs/api/v1/xiaohongshu/profiles/profileid/notes/get.mdx SDK: client.xiaohongshu.listProfileNotes({ profileId: "5c4a8f94000000001003f8c1" }) Parameters: - profileId (required, string) - The creator's profile id (Xiaohongshu's user id), the 24 characters after `/user/profile/` in a profile link, for example `5c4a8f94000000001003f8c1`. A whole profile link, or the app's `xhslink.com` share link, also works. Outcome field: `data.lookupStatus` in `found`, `not_found` curl "https://api.socialfetch.dev/v1/xiaohongshu/profiles/5c4a8f94000000001003f8c1/notes" \ -H "x-api-key: YOUR_API_KEY" ## GET /v1/xiaohongshu/notes/{noteId} Get Xiaohongshu note Credit cost: 1 credit. Failed requests are free. Found, empty and not-found answers are all charged. Auth: API key or x402 payment (no key needed for payment) Docs: https://www.socialfetch.dev/docs/api/v1/xiaohongshu/notes/noteid/get.mdx SDK: client.xiaohongshu.getNote({ noteId: "68ad9c4b000000001b0339a6" }) Parameters: - noteId (required, string) - The note id, the 24 characters after `/explore/` or `/discovery/item/` in a note link, for example `68ad9c4b000000001b0339a6`. Most notes open only with the `xsec_token` of the link they were shared or listed with, so pass the whole note link (its token is read from it), the app's `xhslink.com` share link, or the id with `xsecToken`. - xsecToken (optional, string) - The `xsec_token` from the note's link (the value after `xsec_token=`). Needed for most notes: without it Xiaohongshu shows logged-out visitors only notes it currently promotes. Read from the link when you pass a whole note link as `noteId`. Outcome field: `data.lookupStatus` in `found`, `not_found` curl "https://api.socialfetch.dev/v1/xiaohongshu/notes/68ad9c4b000000001b0339a6" \ -H "x-api-key: YOUR_API_KEY" ## GET /v1/xiaohongshu/notes/{noteId}/comments List Xiaohongshu note comments Credit cost: 1 credit. Failed requests are free. Found, empty and not-found answers are all charged. Auth: API key or x402 payment (no key needed for payment) Docs: https://www.socialfetch.dev/docs/api/v1/xiaohongshu/notes/noteid/comments/get.mdx SDK: client.xiaohongshu.listNoteComments({ noteId: "68ad9c4b000000001b0339a6" }) Parameters: - noteId (required, string) - The note id, the 24 characters after `/explore/` or `/discovery/item/` in a note link, for example `68ad9c4b000000001b0339a6`. Most notes open only with the `xsec_token` of the link they were shared or listed with, so pass the whole note link (its token is read from it), the app's `xhslink.com` share link, or the id with `xsecToken`. - xsecToken (optional, string) - The `xsec_token` from the note's link (the value after `xsec_token=`). Needed for most notes: without it Xiaohongshu shows logged-out visitors only notes it currently promotes. Read from the link when you pass a whole note link as `noteId`. Outcome field: `data.lookupStatus` in `found`, `not_found` curl "https://api.socialfetch.dev/v1/xiaohongshu/notes/68ad9c4b000000001b0339a6/comments" \ -H "x-api-key: YOUR_API_KEY"