# 小红书 API

搜索小红书笔记和用户，按 user_id 查主页资料、已发布笔记和粉丝列表，读取图文和视频笔记详情、评论及同篇楼中楼回复、笔记发布地点，查看话题内容、热榜和蒲公英内容广场榜，搜索商品并读取详情与评价。

- Domain: social · 17 data actions
- Canonical page: https://everyinfra.com/xiaohongshu-api
- Failures and empty results never form a final charge.

## Actions

### search — 关键词搜索
- Mode: sync · Price: 400 credits ($5.56 / 千次)
- Required: keyword

- Optional: content_type, date_range, page_token, sort
- Allowed values: content_type (all/image/video), sort (most_collected/most_commented/most_liked/newest/relevance), date_range (any_time/last_1_year/last_24_hours/last_30_days/last_6_months/last_7_days)

- Returns fields: 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, next_page_token, video_url, duration_sec, duration_seconds, platform, poi_id, poi_name, images, is_goods_note, is_cooperation_note, author_is_verified, updated_at, author_red_id, video_width, video_height

### profile — 主页或对象详情
- Mode: sync · Price: 400 credits ($5.56 / 千次)
- Required: user_id

- Returns fields: user_id, nickname, red_id, url, bio, follower_count, following_count, like_collect_count, post_count, gender, ip_location, avatar_url, is_verified, tags, like_count, collect_count, real_name_info, verification_type, verification_text, location, platform

### user_posts — 用户内容
- Mode: sync · Price: 400 credits ($5.56 / 千次)
- Required: user_id

- Optional: page_token

- Returns fields: 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, next_page_token, video_url, duration_sec, duration_seconds, platform, images, is_goods_note, is_pinned, ip_location

### note — 笔记详情
- Mode: sync · Price: 400 credits ($5.56 / 千次)
- Required: url

- Returns fields: id, url, title, text, like_count, collect_count, comment_count, share_count, posted_at, ip_location, author_name, author_id, is_video, avatar_url, author_url, platform, images, tags, topics, mentioned_users, lat, lng, has_goods, is_cooperation_note, author_red_id, author_is_verified, language, updated_at

### video — 视频详情
- Mode: sync · Price: 400 credits ($5.56 / 千次)
- Required: url

- Returns fields: id, url, video_url, duration_sec, duration_seconds, video_width, video_height, platform

### comments — 评论
- Mode: sync · Price: 400 credits ($5.56 / 千次)
- Required: url

- Optional: page_token, sort
- Allowed values: sort (default/most_liked/newest)

- Returns fields: id, text, like_count, posted_at, ip_location, author_name, author_id, sub_comment_count, note_id, note_url, next_page_token, images, is_author, author_avatar_url, author_red_id, author_is_ai_agent, mentioned_users, comment_tags, sub_comments, platform

### comments_batch — 多链接评论批量采集
- Mode: sync · Price: 400 credits ($5.56 / 千次)
- Required: urls

- Optional: sort
- Allowed values: sort (default/most_liked/newest)

- Returns fields: id, text, like_count, posted_at, ip_location, author_name, author_id, sub_comment_count, note_id, note_url, next_page_token, images, is_author, author_avatar_url, author_red_id, author_is_ai_agent, mentioned_users, comment_tags, sub_comments, platform

### sub_comments — 评论回复
- Mode: sync · Price: 400 credits ($5.56 / 千次)
- Required: url, comment_id

- Optional: page_token

- Returns fields: id, text, like_count, posted_at, ip_location, author_name, author_id, reply_to_id, reply_to_author_name, reply_to_author_id, next_page_token, images, is_author, author_avatar_url, author_red_id, author_is_ai_agent, mentioned_users, comment_tags, platform

### search_users — 用户搜索
- Mode: sync · Price: 400 credits ($5.56 / 千次)
- Required: keyword

- Optional: follower_range, page_token, user_type
- Allowed values: follower_range (100_to_1k/10k_to_100k/1k_to_10k/over_100k/under_100), user_type (business/general/verified_individual)

- Returns fields: user_id, nickname, red_id, avatar_url, url, follower_count, is_verified, verification_type, next_page_token, platform

### hashtag — 话题内容
- Mode: sync · Price: 400 credits ($5.56 / 千次)
- Required: topic_id

- Optional: page_token, sort
- Allowed values: sort (newest/popular)

- Returns fields: 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, next_page_token, video_url, duration_sec, duration_seconds, platform, images

### trending — 热榜
- Mode: sync · Price: 400 credits ($5.56 / 千次)
- Required: —

- Returns fields: id, url, title, author_name, is_video, image_url, platform

### product_search — 商品搜索
- Mode: sync · Price: 400 credits ($5.56 / 千次)
- Required: keyword

- Optional: page_token

- Returns fields: id, title, url, price, original_price, currency, image_url, sold_count, in_stock, shop_id, shop_name, next_page_token, platform

### product_detail — 商品详情
- Mode: sync · Price: 400 credits ($5.56 / 千次)
- Required: product_id

- Returns fields: id, title, url, price, original_price, currency, in_stock, category, sold_count, variant_name, image_urls, detail_image_urls, attributes, shop_id, shop_name, shop_rating, shop_sold_count, shop_user_id, shop_follower_count, platform

### reviews — 评价
- Mode: sync · Price: 400 credits ($5.56 / 千次)
- Required: product_id

- Optional: page_token, sort
- Allowed values: sort (default/newest)

- Returns fields: id, product_id, text, rating, rating_scale, service_rating, logistics_rating, like_count, reply_count, images, tags, sku, posted_date, next_page_token, platform

### followers_list — 粉丝列表
- Mode: sync · Price: 400 credits ($5.56 / 千次)
- Required: user_id

- Optional: page_token

- Returns fields: user_id, nickname, avatar_url, url, follower_count, note_count, of_user, next_page_token, platform

### note_location — 笔记发布地点
- Mode: sync · Price: 400 credits ($5.56 / 千次)
- Required: url

- Returns fields: note_id, url, location_text, city, poi_name, poi_ids, platform

### pgy_content_square — 蒲公英内容广场榜
- Mode: sync · Price: 1152 credits ($16 / 千次)
- Required: —

- Optional: board, keyword, page_token, time_window
- Allowed values: board (app_promo/brand_collab/ecommerce_hot/ecommerce_promo/hot/lead_gen/product_seeding/seeding_direct), time_window (14d/30d/3d/7d)

- Returns fields: rank, id, url, title, is_video, like_count, collect_count, comment_count, view_count, posted_at, images, video_url, duration_sec, duration_seconds, is_ad, author_id, author_name, author_avatar_url, author_follower_count, platform

## Also

- Machine catalog (no key): https://everyinfra.com/openapi.json · GET /api/v1/social/catalog
- Agents guide: https://everyinfra.com/agents.md