EveryData platform API
Xiaohongshu API
The scope of this Xiaohongshu API is Xiaohongshu notes, profiles, comments, nested replies, batches, and trending topics; its 8 actions, including `search`, `profile`, `user_posts`, retain independent inputs and returned-object meanings.
In the Xiaohongshu catalog, `keyword` drives `search` for matching Xiaohongshu results, whereas `user_id` drives `profile` for the selected Xiaohongshu record; a shared identifier never merges their response fields.
- Endpoint
- POST /api/v1/social
- Capabilities
- 8
- Per 1,000
- $5.556
Available capabilities
Compare the Xiaohongshu actions by required input, returned data, and price. Use the action identifier exactly as shown in your request.
| Action | Required | Optional | Delivery | Limit | Per 1,000 | Response fields |
|---|---|---|---|---|---|---|
searchSearch Search public results on Xiaohongshu. Accepts these parameters: | keyword | content_type, sort | Sync delivery | Catalog values: defaultLimit=20, maxLimit=50. A limit can control pages or per-parent expansion for some actions, so it is not always a final row count. | $5.56 per 1,000 requests | id · url · title · text · like_count · collect_count · comment_count · share_count · posted_at · image_url · author_name · author_id · avatar_url · author_url · is_video · platform |
profileProfiles Retrieve public profile details from Xiaohongshu. Accepts these parameters: | user_id | content_type, min_likes, sort | Sync delivery | — | $5.56 per 1,000 requests | user_id · nickname · red_id · url · bio · follower_count · following_count · like_collect_count · post_count · gender · ip_location · avatar_url · is_verified · tags · platform |
user_postsPosts by user Retrieve public posts from Xiaohongshu. Accepts these parameters: | user_id | content_type, min_likes, sort | Sync delivery | Catalog values: defaultLimit=20, maxLimit=100. A limit can control pages or per-parent expansion for some actions, so it is not always a final row count. | $5.56 per 1,000 requests | id · url · title · text · like_count · collect_count · comment_count · share_count · posted_at · image_url · author_name · author_id · avatar_url · author_url · is_video · platform |
noteNote details Use the | url | content_type, sort | Sync delivery | — | $5.56 per 1,000 requests | id · url · title · text · like_count · collect_count · comment_count · share_count · posted_at · ip_location · author_name · author_id · platform |
commentsComments Retrieve public comments from Xiaohongshu. Accepts these parameters: | url | content_type, sort | Sync delivery | Catalog values: defaultLimit=30, maxLimit=200. A limit can control pages or per-parent expansion for some actions, so it is not always a final row count. | $5.56 per 1,000 requests | id · text · like_count · posted_at · ip_location · author_name · author_id · sub_comment_count · note_id · note_url · platform |
comments_batchComments from multiple URLs Use the | urls | — | Sync delivery | Catalog values: defaultLimit=30, maxLimit=200. A limit can control pages or per-parent expansion for some actions, so it is not always a final row count. | $5.56 per 1,000 requests | id · text · like_count · posted_at · ip_location · author_name · author_id · sub_comment_count · note_id · note_url · platform |
sub_commentsComment replies Retrieve comment replies from Xiaohongshu. Accepts these parameters: | url, comment_id | content_type, sort | Sync delivery | Catalog values: defaultLimit=10, maxLimit=30. A limit can control pages or per-parent expansion for some actions, so it is not always a final row count. | $5.56 per 1,000 requests | id · text · like_count · posted_at · ip_location · author_name · author_id · reply_to_id · platform |
trendingTrending Retrieve current trends from Xiaohongshu. Accepts these parameters: | content_type, date_range, sort | Sync delivery | Catalog values: defaultLimit=20, maxLimit=30. A limit can control pages or per-parent expansion for some actions, so it is not always a final row count. | $5.56 per 1,000 requests | id · url · title · author_name · is_video · image_url · platform |
What does each Xiaohongshu action accept?
Each answer below pairs one callable action with its real inputs. Parameter meanings and allowed values are action-specific; a familiar name does not carry the same meaning across every platform.
Official sources are linked only to clarify the platform term beside them. They do not imply platform authorization or endorsement, and they do not add official-site features to the EveryInfra API contract.
What do the Xiaohongshu search parameters mean?
Search public results on Xiaohongshu. Accepts these parameters: keyword, content_type, and sort. Returns these fields: title, text, author_name, and author_id.
keywordRequired- Specifies the query string used to search Xiaohongshu note content (e.g., "sensitive skin sunscreen") in the search action. Searches note text, not user IDs.
content_typeOptional- Filters notes by content type. Allowed values vary by action: all or all_types (no filter), image or image_notes_only (image notes), video, videos_only, or video_notes_only (video notes), and live_notes_only (live stream notes). Only pass values explicitly supported by the target action.Allowed values:
allimagevideoXiaohongshu: Image-Text and Video Note Entry PointsXiaohongshu public deeplink documentation separately lists image-text notes, video notes, and note comment pages. This reference only cites distinctions between content types; app redirect parameters in the documentation cannot be passed directly to this endpoint.Checked sortOptional- Sets the sorting order for notes or comments. Options include relevance, newest, popular, most_liked, most_commented, and most_collected. Supported values vary by action; search sorting values cannot be applied to comment endpoints.Allowed values:
most_collectedmost_commentedmost_likednewestrelevance
What do the Xiaohongshu profile parameters mean?
Retrieve public profile details from Xiaohongshu. Accepts these parameters: user_id, min_likes, content_type, and sort. Returns these fields: nickname, tags, avatar_url, and like_collect_count.
user_idRequired- Specifies the Xiaohongshu user ID (the identifier following /user/profile/ in the URL) or full profile URL for the profile and user_posts actions. Used to fetch profile details or published notes; does not accept username display names.
content_typeOptional- Filters notes by content type. Allowed values vary by action: all or all_types (no filter), image or image_notes_only (image notes), video, videos_only, or video_notes_only (video notes), and live_notes_only (live stream notes). Only pass values explicitly supported by the target action.Allowed values:
allimage_notes_onlyvideos_only min_likesOptional- Filters retrieved notes to those meeting a minimum like threshold. Accepts a non-negative integer. Controls post filtering by engagement scale, not the maximum number of results returned.
sortOptional- Sets the sorting order for notes or comments. Options include relevance, newest, popular, most_liked, most_commented, and most_collected. Supported values vary by action; search sorting values cannot be applied to comment endpoints.Allowed values:
newestpopularrelevance
What do the Xiaohongshu user_posts parameters mean?
Retrieve public posts from Xiaohongshu. Accepts these parameters: user_id, sort, min_likes, and content_type. Returns these fields: title, avatar_url, is_video, and posted_at.
user_idRequired- Specifies the Xiaohongshu user ID (the identifier following /user/profile/ in the URL) or full profile URL for the profile and user_posts actions. Used to fetch profile details or published notes; does not accept username display names.
content_typeOptional- Filters notes by content type. Allowed values vary by action: all or all_types (no filter), image or image_notes_only (image notes), video, videos_only, or video_notes_only (video notes), and live_notes_only (live stream notes). Only pass values explicitly supported by the target action.Allowed values:
allimage_notes_onlyvideos_only min_likesOptional- Filters retrieved notes to those meeting a minimum like threshold. Accepts a non-negative integer. Controls post filtering by engagement scale, not the maximum number of results returned.
sortOptional- Sets the sorting order for notes or comments. Options include relevance, newest, popular, most_liked, most_commented, and most_collected. Supported values vary by action; search sorting values cannot be applied to comment endpoints.Allowed values:
newestpopularrelevance
What do the Xiaohongshu note parameters mean?
Use the note action on Xiaohongshu. Accepts these parameters: url, content_type, and sort. Returns these fields: text, like_count, title, and share_count.
urlRequired- Specifies the full Xiaohongshu note URL, formatted as /explore/<note_id> or /discovery/item/<note_id>. Use recent search URLs that retain query parameters like xsec_token. The sub_comments action requires both this url and a valid comment_id.
content_typeOptional- Filters notes by content type. Allowed values vary by action: all or all_types (no filter), image or image_notes_only (image notes), video, videos_only, or video_notes_only (video notes), and live_notes_only (live stream notes). Only pass values explicitly supported by the target action.Allowed values:
allimagevideo sortOptional- Sets the sorting order for notes or comments. Options include relevance, newest, popular, most_liked, most_commented, and most_collected. Supported values vary by action; search sorting values cannot be applied to comment endpoints.Allowed values:
most_collectedmost_commentedmost_likednewestrelevance
What do the Xiaohongshu comments parameters mean?
Retrieve public comments from Xiaohongshu. Accepts these parameters: url, sort, and content_type. Returns these fields: author_id, posted_at, like_count, and note_id.
urlRequired- Specifies the full Xiaohongshu note URL, formatted as /explore/<note_id> or /discovery/item/<note_id>. Use recent search URLs that retain query parameters like xsec_token. The sub_comments action requires both this url and a valid comment_id.
content_typeOptional- Filters notes by content type. Allowed values vary by action: all or all_types (no filter), image or image_notes_only (image notes), video, videos_only, or video_notes_only (video notes), and live_notes_only (live stream notes). Only pass values explicitly supported by the target action.Allowed values:
allimagevideo sortOptional- Sets the sorting order for notes or comments. Options include relevance, newest, popular, most_liked, most_commented, and most_collected. Supported values vary by action; search sorting values cannot be applied to comment endpoints.Allowed values:
most_collectedmost_commentedmost_likednewestrelevance
What do the Xiaohongshu comments_batch parameters mean?
Use the comments_batch action on Xiaohongshu. Accepts these parameters: urls. Returns these fields: text, posted_at, note_id, and author_id.
urlsRequired- Specifies an array of 1 to 20 Xiaohongshu note URLs for the comments_batch action. Each URL must contain a valid note ID and an xsec_token. Billing is per target note; check partial or missed response fields if some notes fail rather than assuming zero comments exist.
What do the Xiaohongshu sub_comments parameters mean?
Retrieve comment replies from Xiaohongshu. Accepts these parameters: url, comment_id, content_type, and sort. Returns these fields: text, posted_at, author_name, and ip_location.
urlRequired- Specifies the full Xiaohongshu note URL, formatted as /explore/<note_id> or /discovery/item/<note_id>. Use recent search URLs that retain query parameters like xsec_token. The sub_comments action requires both this url and a valid comment_id.
comment_idRequired- Specifies the parent comment ID to retrieve sub-replies for in the sub_comments action. Obtain this ID from the comments response for the same note and pair it with the corresponding url. It is not a note ID or user ID.
content_typeOptional- Filters notes by content type. Allowed values vary by action: all or all_types (no filter), image or image_notes_only (image notes), video, videos_only, or video_notes_only (video notes), and live_notes_only (live stream notes). Only pass values explicitly supported by the target action.Allowed values:
allimagevideo sortOptional- Sets the sorting order for notes or comments. Options include relevance, newest, popular, most_liked, most_commented, and most_collected. Supported values vary by action; search sorting values cannot be applied to comment endpoints.Allowed values:
most_collectedmost_commentedmost_likednewestrelevance
What do the Xiaohongshu trending parameters mean?
Retrieve current trends from Xiaohongshu. Accepts these parameters: date_range, content_type, and sort. Returns these fields: author_name, image_url, is_video, and title.
content_typeOptional- Filters notes by content type. Allowed values vary by action: all or all_types (no filter), image or image_notes_only (image notes), video, videos_only, or video_notes_only (video notes), and live_notes_only (live stream notes). Only pass values explicitly supported by the target action.Allowed values:
all_typesimage_notes_onlylive_notes_onlyvideo_notes_only date_rangeOptional- Filters published notes by relative time window in the trending action. Allowed values are any_time, last_24_hours, last_7_days, and last_6_months. Applies to note creation dates, not comment timestamps.Allowed values:
any_timelast_24_hourslast_6_monthslast_7_days sortOptional- Sets the sorting order for notes or comments. Options include relevance, newest, popular, most_liked, most_commented, and most_collected. Supported values vary by action; search sorting values cannot be applied to comment endpoints.Allowed values:
most_collectedmost_commentedmost_likednewestrelevance
How to use the Xiaohongshu API
- 01Read the public catalog and choose a platform action.
- 02Send the platform, action, and required parameters to POST /api/v1/social.
- 03Handle a synchronous result or poll the returned job ID when the selected action is asynchronous.
- 04Store the structured response fields needed by your application.
curl -X POST https://api.everyinfra.com/api/v1/social \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"platform":"xiaohongshu","action":"search","params":{"keyword":"<keyword>"}}'
Xiaohongshu API questions
What can I retrieve with the Xiaohongshu API?
Set platform to xiaohongshu. The current catalog lists search, profiles, posts by user, note details, comments, and more. These action names identify different Xiaohongshu objects or views; they are not interchangeable search modes.
Which input starts a Xiaohongshu `search` request?
Specifies the query string used to search Xiaohongshu note content (e.g., "sensitive skin sunscreen") in the search action. Searches note text, not user IDs. Send it as keyword inside params.
Which fields can Xiaohongshu `search` return?
Its declared schema includes title, text, like_count, and collect_count. A declared field can still be absent from an individual source record, and every other action has its own field list.
Does every Xiaohongshu action return immediately?
No assumption is needed: this page labels each action's delivery mode. The current catalog contains sync delivery; poll a returned job ID only for an action labeled asynchronous.