核心接口
小红书搜索 API
小红书搜索接口（search）：每次成功调用 1.5 credits，支持 HTTP 与 Remote MCP，输入、数据来源和计费规则清晰。
01 / 核心接口
一次请求
成功或空结果每次 1.5 credits，失败不计费。
把 PASTE_PUBLIC 占位符换成受支持的公开标识。这是请求模板，不会自动执行。
curl --request POST 'https://api.socialtoai.com/v1/search' \
--header "X-API-Key: $SOCIALTOAI_API_KEY" \
--header 'Content-Type: application/json' \
--header 'Idempotency-Key: REPLACE_WITH_A_UNIQUE_REQUEST_ID' \
--data '{"platform":"xiaohongshu","query":"AI research","count":5}'02 / 核心接口
原生支持
结果类型：item or profile_card (type=user)。翻页：使用返回的不透明 cursor。
sort：relevance, latest, most_liked, most_collected, most_comments。
time_range：1d, 7d, all。
content_type：all, video, image。
type：content, user。
以上取值来自参考卡。用户查找或特定内容类型可能还有额外限制。请以响应里的 applied_params 和 warnings 为准，不要假定不支持的筛选已生效。
03 / 核心接口
经过结构校验的示例
示意结果，只含一条虚构数据和示例试用余额，用来展示响应结构，不是实时结果，也不代表线上可用率。
{
"request_id": "example_only_not_a_live_call",
"schema_version": "v1",
"fetched_at": "2026-09-05T00:00:00Z",
"status": "ok",
"applied_params": {},
"warnings": [],
"items": [
{
"kind": "item",
"id": "EXAMPLE_ITEM_ID",
"author": {
"name": "example_author"
},
"published_at": "2026-09-01T08:30:00Z",
"metrics": {
"likes": 412,
"comments": 96
},
"title": "Illustrative post title",
"text": "Illustrative excerpt, not real content."
}
],
"platform": "xiaohongshu",
"billing": {
"cost": 1.5,
"balance": 0.5,
"unit": "credits",
"pricing": "standard"
}
}04 / 核心接口
平台限制
平台隐藏了浏览量，因此不输出。缺失的指标不等于 0。
搜索的 30d 筛选会回退为 all 并附带 warning。
商品与电商数据不在六个核心动作内。
分享短链解析与核心供给的实测证据相互独立，建议使用稳定的公开笔记链接或 ID。
原生 1d/7d 搜索筛选可能返回较早的内容。若返回日期早于请求窗口，该页会报告 time_range=all 并附带 warning；内容会保留，不会额外搜索；缺失的日期仍无法核实。
常见问题
这个调用多少钱？
成功或空结果每次 1.5 credits，失败不扣费。
可以翻页吗？
只使用返回的不透明 cursor，并保持平台和查询不变。请检查 has_more 和剩余预算。
平台的所有功能都覆盖了吗？
平台隐藏了浏览量，因此不输出。缺失的指标不等于 0。搜索的 30d 筛选会回退为 all 并附带 warning。商品与电商数据不在六个核心动作内。分享短链解析与核心供给的实测证据相互独立，建议使用稳定的公开笔记链接或 ID。原生 1d/7d 搜索筛选可能返回较早的内容。若返回日期早于请求窗口，该页会报告 time_range=all 并附带 warning；内容会保留，不会额外搜索；缺失的日期仍无法核实。