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 Use Xiaohongshu | 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 Use Xiaohongshu account input with | 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 The | 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 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 Xiaohongshu | 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 | 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 Call | 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 Choose | 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?
Use Xiaohongshu search with keyword for Xiaohongshu public results. Xiaohongshu search keeps Xiaohongshu field meanings action-specific. Call Xiaohongshu search with keyword, content_type, and sort; Xiaohongshu search exposes url, title, text, author_name, author_id, image_url, posted_at, platform, share_count, comment_count, collect_count, like_count, is_video, avatar_url, author_url, and 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?
Use Xiaohongshu account input with profile; Xiaohongshu then reads public record. Use Xiaohongshu profile to read one Xiaohongshu public record. For Xiaohongshu profile, supply user_id, min_likes, content_type, and sort; results include nickname, tags, url, avatar_url, like_collect_count, red_id, follower_count, gender, platform, post_count, ip_location, is_verified, bio, following_count, and user_id.
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?
The user_posts action fetches posts from a specified account. Use user_id to identify the account. Xiaohongshu user_posts takes user_id, sort, min_likes, and content_type and yields title, avatar_url, is_video, posted_at, share_count, comment_count, image_url, platform, author_url, text, id, url, like_count, author_id, author_name, and 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 note parameters mean?
The note selection separates one note from other Xiaohongshu objects. Use Xiaohongshu note with url; Xiaohongshu then selects one note. Call Xiaohongshu note with url, content_type, and sort; Xiaohongshu note exposes id, text, like_count, platform, title, share_count, author_id, posted_at, url, author_name, collect_count, ip_location, and comment_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?
Xiaohongshu comments reads top-level discussion rows for the note identified by url. Keep note_id and note_url with each author and treat sub_comment_count only as a visible count, because nested replies belong to sub_comments and this response is not a complete tree. Xiaohongshu comments takes url, sort, and content_type and yields id, platform, author_id, posted_at, like_count, note_id, author_name, sub_comment_count, note_url, text, 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.
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 comments_batch with urls to retrieve comments for several Xiaohongshu notes. Pagination and visibility limits may prevent a complete thread history. For Xiaohongshu comments_batch, supply urls; results include text, posted_at, note_id, author_id, sub_comment_count, id, author_name, platform, like_count, ip_location, and note_url.
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?
Call sub_comments to work with nested replies to a selected comment from Xiaohongshu. Use Xiaohongshu sub_comments with url; Xiaohongshu then selects nested replies to a selected comment together with comment_id. Pass url, comment_id, content_type, and sort to Xiaohongshu sub_comments; returned objects expose text, platform, posted_at, author_name, ip_location, reply_to_id, id, like_count, and author_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.
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?
Choose trending when the Xiaohongshu target is the current trending sample. The catalog declares no required selector. For Xiaohongshu trending, supply date_range, content_type, and sort; results include url, id, author_name, platform, 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.