| 123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959960961962963964965 |
- {
- "version": "1.1.0",
- "updatedAt": "2026-06-22",
- "gateway": {
- "social": {
- "baseUrl": "https://server.fmode.cn/api/voc-social",
- "auth": "Authorization: Bearer <r: 开头的会话 token>",
- "upstream": "我们的中转网关(已封装请求头,直接中转,对外不暴露具体数据供应商)。",
- "billing": "每次转发调用扣除 1 次社交平台 API 额度(缓存命中也会计费)。",
- "note": "这是一个通用转发网关:任意 proxyPath 都会被透传到我们的中转上游。本清单列出已验证的抖音、小红书常用接口;未列出的接口可以直接用 voc_api_call 传 rawPath + method + params 调用,无需改代码。",
- "rawPathHint": "调用未在清单中的接口时,把相对路径填到 voc_api_call 的 rawPath,例如 douyin/search/fetch_general_search_v2,并按对应平台的参数规则拼 query/body。"
- }
- },
- "platforms": [
- {
- "key": "douyin",
- "label": "抖音",
- "status": "verified"
- },
- {
- "key": "xiaohongshu",
- "label": "小红书",
- "status": "verified"
- }
- ],
- "endpoints": [
- {
- "id": "douyin.search_general",
- "platform": "douyin",
- "channel": "social",
- "title": "抖音综合搜索",
- "summary": "按关键词做抖音综合搜索(视频/用户/话题混合)。任意行业/方向关键词均可用于趋势与 VOC 选题采集。",
- "proxyPath": "douyin/search/fetch_general_search_v2",
- "method": "POST",
- "paramsIn": "body",
- "tags": [
- "抖音",
- "douyin",
- "搜索",
- "search",
- "综合",
- "视频",
- "关键词",
- "voc",
- "趋势"
- ],
- "params": [
- {
- "name": "keyword",
- "in": "body",
- "type": "string",
- "required": true,
- "desc": "搜索关键词,任意行业/方向均可,例如 股权律师、医美 玻尿酸、少儿编程、新能源汽车。"
- },
- {
- "name": "cursor",
- "in": "body",
- "type": "integer",
- "required": false,
- "default": 0,
- "desc": "分页偏移游标,首页为 0,翻页用上一次返回的 cursor。"
- },
- {
- "name": "sort_type",
- "in": "body",
- "type": "string",
- "required": false,
- "default": "0",
- "desc": "排序:0 综合,1 最多点赞,2 最新发布。"
- },
- {
- "name": "publish_time",
- "in": "body",
- "type": "string",
- "required": false,
- "default": "0",
- "desc": "发布时间:0 不限,1 一天内,7 一周内,180 半年内。"
- },
- {
- "name": "filter_duration",
- "in": "body",
- "type": "string",
- "required": false,
- "default": "0",
- "desc": "时长筛选:0 不限,0-1 一分钟内,1-5 一到五分钟,5-10000 五分钟以上。"
- },
- {
- "name": "content_type",
- "in": "body",
- "type": "string",
- "required": false,
- "default": "0",
- "desc": "内容类型:0 不限,1 视频,2 图集,3 文章。"
- },
- {
- "name": "search_id",
- "in": "body",
- "type": "string",
- "required": false,
- "default": "",
- "desc": "连续翻页时透传上一次返回的 search_id。"
- },
- {
- "name": "backtrace",
- "in": "body",
- "type": "string",
- "required": false,
- "default": "",
- "desc": "连续翻页时透传上一次返回的 backtrace。"
- }
- ],
- "responseHint": "data 下为搜索结果列表,含视频 aweme_id、作者、标题、互动数;翻页用返回的 cursor/search_id。"
- },
- {
- "id": "douyin.search_video",
- "platform": "douyin",
- "channel": "social",
- "title": "抖音视频搜索",
- "summary": "按关键词只搜索抖音视频。适合按词采集相关短视频做内容/口碑分析。",
- "proxyPath": "douyin/search/fetch_video_search_v2",
- "method": "POST",
- "paramsIn": "body",
- "tags": [
- "抖音",
- "douyin",
- "视频",
- "video",
- "搜索",
- "search",
- "关键词"
- ],
- "params": [
- {
- "name": "keyword",
- "in": "body",
- "type": "string",
- "required": true,
- "desc": "搜索关键词,任意行业/方向均可,例如 股权律师、医美 玻尿酸、少儿编程、新能源汽车。"
- },
- {
- "name": "cursor",
- "in": "body",
- "type": "integer",
- "required": false,
- "default": 0,
- "desc": "分页偏移游标,首页为 0,翻页用上一次返回的 cursor。"
- },
- {
- "name": "sort_type",
- "in": "body",
- "type": "string",
- "required": false,
- "default": "0",
- "desc": "排序:0 综合,1 最多点赞,2 最新发布。"
- },
- {
- "name": "publish_time",
- "in": "body",
- "type": "string",
- "required": false,
- "default": "0",
- "desc": "发布时间:0 不限,1 一天内,7 一周内,180 半年内。"
- },
- {
- "name": "filter_duration",
- "in": "body",
- "type": "string",
- "required": false,
- "default": "0",
- "desc": "时长筛选:0 不限,0-1 一分钟内,1-5 一到五分钟,5-10000 五分钟以上。"
- },
- {
- "name": "content_type",
- "in": "body",
- "type": "string",
- "required": false,
- "default": "0",
- "desc": "内容类型:0 不限,1 视频,2 图集,3 文章。"
- },
- {
- "name": "search_id",
- "in": "body",
- "type": "string",
- "required": false,
- "default": "",
- "desc": "连续翻页时透传上一次返回的 search_id。"
- },
- {
- "name": "backtrace",
- "in": "body",
- "type": "string",
- "required": false,
- "default": "",
- "desc": "连续翻页时透传上一次返回的 backtrace。"
- }
- ],
- "responseHint": "返回视频列表,含 aweme_id、作者、统计数据;翻页用 cursor/search_id。"
- },
- {
- "id": "douyin.search_user",
- "platform": "douyin",
- "channel": "social",
- "title": "抖音用户搜索",
- "summary": "按关键词搜索抖音用户/账号,定位某行业的达人或竞品账号。",
- "proxyPath": "douyin/search/fetch_user_search_v2",
- "method": "POST",
- "paramsIn": "body",
- "tags": [
- "抖音",
- "douyin",
- "用户",
- "user",
- "账号",
- "搜索",
- "search",
- "达人",
- "kol"
- ],
- "params": [
- {
- "name": "keyword",
- "in": "body",
- "type": "string",
- "required": true,
- "desc": "搜索关键词(账号名/行业词)。"
- },
- {
- "name": "cursor",
- "in": "body",
- "type": "integer",
- "required": false,
- "default": 0,
- "desc": "分页偏移游标,首页为 0。"
- },
- {
- "name": "search_id",
- "in": "body",
- "type": "string",
- "required": false,
- "default": "",
- "desc": "连续翻页时透传上一次返回的 search_id。"
- }
- ],
- "responseHint": "返回用户列表,含 sec_user_id、昵称、粉丝数;sec_user_id 可继续用于 user_profile / user_posts。"
- },
- {
- "id": "douyin.video_detail",
- "platform": "douyin",
- "channel": "social",
- "title": "抖音视频详情",
- "summary": "按视频 id 获取单个抖音视频的完整数据(标题、作者、统计、视频地址等)。",
- "proxyPath": "douyin/app/v3/fetch_one_video",
- "method": "GET",
- "paramsIn": "query",
- "tags": [
- "抖音",
- "douyin",
- "视频",
- "video",
- "详情",
- "detail",
- "aweme"
- ],
- "params": [
- {
- "name": "aweme_id",
- "in": "query",
- "type": "string",
- "required": true,
- "desc": "视频 id(aweme_id),来自搜索/评论返回。"
- }
- ],
- "responseHint": "返回单个视频对象,含统计、作者、话题、视频/图集地址。"
- },
- {
- "id": "douyin.video_comments",
- "platform": "douyin",
- "channel": "social",
- "title": "抖音视频评论列表",
- "summary": "按视频 id 拉取抖音视频的一级评论。VOC 主力接口:采集用户真实评论。",
- "proxyPath": "douyin/app/v3/fetch_video_comments",
- "method": "GET",
- "paramsIn": "query",
- "tags": [
- "抖音",
- "douyin",
- "评论",
- "comment",
- "voc",
- "口碑",
- "视频"
- ],
- "params": [
- {
- "name": "aweme_id",
- "in": "query",
- "type": "string",
- "required": true,
- "desc": "视频 id(aweme_id)。"
- },
- {
- "name": "cursor",
- "in": "query",
- "type": "integer",
- "required": false,
- "default": 0,
- "desc": "分页游标,首页为 0,翻页用上一次返回的 cursor。"
- },
- {
- "name": "count",
- "in": "query",
- "type": "integer",
- "required": false,
- "default": 20,
- "desc": "每页数量,建议 20。"
- }
- ],
- "responseHint": "返回评论列表,含 comment_id、文本、点赞、子评论数;翻页用返回的 cursor。"
- },
- {
- "id": "douyin.comment_replies",
- "platform": "douyin",
- "channel": "social",
- "title": "抖音评论回复",
- "summary": "按视频 id + 评论 id 拉取某条评论下的回复(楼中楼),用于深挖讨论。",
- "proxyPath": "douyin/app/v3/fetch_video_comment_replies",
- "method": "GET",
- "paramsIn": "query",
- "tags": [
- "抖音",
- "douyin",
- "评论",
- "回复",
- "reply",
- "comment",
- "楼中楼",
- "voc"
- ],
- "params": [
- {
- "name": "item_id",
- "in": "query",
- "type": "string",
- "required": true,
- "desc": "视频 id(aweme_id)。"
- },
- {
- "name": "comment_id",
- "in": "query",
- "type": "string",
- "required": true,
- "desc": "一级评论 id,来自 video_comments 返回。"
- },
- {
- "name": "cursor",
- "in": "query",
- "type": "integer",
- "required": false,
- "default": 0,
- "desc": "分页游标,首页为 0。"
- },
- {
- "name": "count",
- "in": "query",
- "type": "integer",
- "required": false,
- "default": 20,
- "desc": "每页数量,建议 20。"
- }
- ],
- "responseHint": "返回某条评论的回复列表;翻页用返回的 cursor。"
- },
- {
- "id": "douyin.user_profile",
- "platform": "douyin",
- "channel": "social",
- "title": "抖音用户主页信息",
- "summary": "按 sec_user_id 获取抖音用户主页资料(昵称、签名、粉丝/获赞等)。",
- "proxyPath": "douyin/app/v3/handler_user_profile",
- "method": "GET",
- "paramsIn": "query",
- "tags": [
- "抖音",
- "douyin",
- "用户",
- "user",
- "主页",
- "profile",
- "达人",
- "竞品"
- ],
- "params": [
- {
- "name": "sec_user_id",
- "in": "query",
- "type": "string",
- "required": true,
- "desc": "用户 sec_user_id,来自 search_user 或视频返回。"
- }
- ],
- "responseHint": "返回用户资料对象,含粉丝数、获赞数、作品数、签名。"
- },
- {
- "id": "douyin.user_posts",
- "platform": "douyin",
- "channel": "social",
- "title": "抖音用户发布视频",
- "summary": "按 sec_user_id 拉取某用户主页发布的视频列表,用于竞品/达人内容盘点。",
- "proxyPath": "douyin/app/v3/fetch_user_post_videos",
- "method": "GET",
- "paramsIn": "query",
- "tags": [
- "抖音",
- "douyin",
- "用户",
- "作品",
- "posts",
- "video",
- "竞品",
- "达人"
- ],
- "params": [
- {
- "name": "sec_user_id",
- "in": "query",
- "type": "string",
- "required": true,
- "desc": "用户 sec_user_id。"
- },
- {
- "name": "max_cursor",
- "in": "query",
- "type": "integer",
- "required": false,
- "default": 0,
- "desc": "分页游标,首页为 0,翻页用上一次返回的 max_cursor。"
- },
- {
- "name": "count",
- "in": "query",
- "type": "integer",
- "required": false,
- "default": 20,
- "desc": "每页数量,建议 20。"
- },
- {
- "name": "sort_type",
- "in": "query",
- "type": "integer",
- "required": false,
- "default": 0,
- "desc": "排序类型,0 默认。"
- }
- ],
- "responseHint": "返回该用户的视频列表;翻页用返回的 max_cursor。"
- },
- {
- "id": "douyin.video_statistics",
- "platform": "douyin",
- "channel": "social",
- "title": "抖音视频数据统计",
- "summary": "按一个或多个视频 id 获取统计数据(点赞、下载、播放、分享)。",
- "proxyPath": "douyin/app/v3/fetch_video_statistics",
- "method": "GET",
- "paramsIn": "query",
- "tags": [
- "抖音",
- "douyin",
- "统计",
- "statistics",
- "点赞",
- "播放",
- "视频"
- ],
- "params": [
- {
- "name": "aweme_ids",
- "in": "query",
- "type": "string",
- "required": true,
- "desc": "视频 id,多个用逗号分隔(aweme_ids)。"
- }
- ],
- "responseHint": "返回各视频的 like/play/download/share 统计。"
- },
- {
- "id": "douyin.hot_search_list",
- "platform": "douyin",
- "channel": "social",
- "title": "抖音热搜榜",
- "summary": "获取抖音热搜榜单数据,用于选题与趋势监测。",
- "proxyPath": "douyin/app/v3/fetch_hot_search_list",
- "method": "GET",
- "paramsIn": "query",
- "tags": [
- "抖音",
- "douyin",
- "热搜",
- "hot",
- "榜单",
- "趋势",
- "选题"
- ],
- "params": [
- {
- "name": "board_type",
- "in": "query",
- "type": "string",
- "required": false,
- "default": "0",
- "desc": "榜单类型,0 默认热榜。"
- },
- {
- "name": "board_sub_type",
- "in": "query",
- "type": "string",
- "required": false,
- "default": "",
- "desc": "榜单子类型,可留空。"
- }
- ],
- "responseHint": "返回热搜词条列表,含热度值。"
- },
- {
- "id": "xiaohongshu.search_notes",
- "platform": "xiaohongshu",
- "channel": "social",
- "title": "小红书笔记搜索",
- "summary": "按关键词搜索小红书笔记。任意行业/方向关键词均可用于 VOC 选题与口碑采集。",
- "proxyPath": "xiaohongshu/app/search_notes",
- "method": "GET",
- "paramsIn": "query",
- "tags": [
- "小红书",
- "xiaohongshu",
- "xhs",
- "笔记",
- "note",
- "搜索",
- "search",
- "关键词",
- "voc"
- ],
- "params": [
- {
- "name": "keyword",
- "in": "query",
- "type": "string",
- "required": true,
- "desc": "搜索关键词,任意行业/方向均可。"
- },
- {
- "name": "page",
- "in": "query",
- "type": "integer",
- "required": true,
- "default": 1,
- "desc": "页码,从 1 开始,翻页递增。"
- },
- {
- "name": "sort_type",
- "in": "query",
- "type": "string",
- "required": false,
- "default": "general",
- "desc": "排序:general 综合,time_descending 最新,popularity_descending 最热。"
- },
- {
- "name": "filter_note_type",
- "in": "query",
- "type": "string",
- "required": false,
- "default": "不限",
- "desc": "笔记类型筛选:不限 / 视频 / 图文。"
- },
- {
- "name": "filter_note_time",
- "in": "query",
- "type": "string",
- "required": false,
- "default": "不限",
- "desc": "发布时间筛选:不限 / 一天内 / 一周内 / 半年内。"
- },
- {
- "name": "search_id",
- "in": "query",
- "type": "string",
- "required": false,
- "default": "",
- "desc": "连续翻页时透传上一次返回的 search_id。"
- },
- {
- "name": "session_id",
- "in": "query",
- "type": "string",
- "required": false,
- "default": "",
- "desc": "连续翻页时透传上一次返回的 session_id。"
- }
- ],
- "responseHint": "返回笔记列表,含 note_id、标题、作者、互动数;翻页递增 page 并透传 search_id/session_id。"
- },
- {
- "id": "xiaohongshu.note_detail",
- "platform": "xiaohongshu",
- "channel": "social",
- "title": "小红书笔记详情",
- "summary": "按 note_id(或分享文案)获取小红书笔记完整内容。",
- "proxyPath": "xiaohongshu/app/get_note_info",
- "method": "GET",
- "paramsIn": "query",
- "tags": [
- "小红书",
- "xiaohongshu",
- "xhs",
- "笔记",
- "note",
- "详情",
- "detail"
- ],
- "params": [
- {
- "name": "note_id",
- "in": "query",
- "type": "string",
- "required": true,
- "desc": "笔记 id(note_id),来自 search_notes 返回。"
- },
- {
- "name": "share_text",
- "in": "query",
- "type": "string",
- "required": false,
- "default": "",
- "desc": "可选:直接传小红书分享文案/链接,与 note_id 二选一。"
- }
- ],
- "responseHint": "返回单条笔记对象,含正文、图片/视频、话题、互动数。"
- },
- {
- "id": "xiaohongshu.note_comments",
- "platform": "xiaohongshu",
- "channel": "social",
- "title": "小红书笔记评论",
- "summary": "按 note_id 拉取小红书笔记的一级评论。VOC 主力接口。",
- "proxyPath": "xiaohongshu/app/get_note_comments",
- "method": "GET",
- "paramsIn": "query",
- "tags": [
- "小红书",
- "xiaohongshu",
- "xhs",
- "评论",
- "comment",
- "voc",
- "口碑"
- ],
- "params": [
- {
- "name": "note_id",
- "in": "query",
- "type": "string",
- "required": true,
- "desc": "笔记 id(note_id)。"
- },
- {
- "name": "start",
- "in": "query",
- "type": "string",
- "required": false,
- "default": "",
- "desc": "分页游标,首页留空,翻页用上一次返回的 start。"
- },
- {
- "name": "sort_strategy",
- "in": "query",
- "type": "integer",
- "required": false,
- "default": 1,
- "desc": "排序:1 默认。"
- }
- ],
- "responseHint": "返回评论列表,含 comment_id、文本、点赞、子评论数;翻页用返回的 start。"
- },
- {
- "id": "xiaohongshu.sub_comments",
- "platform": "xiaohongshu",
- "channel": "social",
- "title": "小红书评论回复(楼中楼)",
- "summary": "按 note_id + comment_id 拉取某条评论下的回复,用于深挖讨论。",
- "proxyPath": "xiaohongshu/app/get_sub_comments",
- "method": "GET",
- "paramsIn": "query",
- "tags": [
- "小红书",
- "xiaohongshu",
- "xhs",
- "评论",
- "回复",
- "reply",
- "sub",
- "楼中楼",
- "voc"
- ],
- "params": [
- {
- "name": "note_id",
- "in": "query",
- "type": "string",
- "required": true,
- "desc": "笔记 id(note_id)。"
- },
- {
- "name": "comment_id",
- "in": "query",
- "type": "string",
- "required": true,
- "desc": "一级评论 id,来自 note_comments 返回。"
- },
- {
- "name": "start",
- "in": "query",
- "type": "string",
- "required": false,
- "default": "",
- "desc": "分页游标,首页留空,翻页用上一次返回的 start。"
- }
- ],
- "responseHint": "返回某条评论的回复列表;翻页用返回的 start。"
- },
- {
- "id": "xiaohongshu.user_info",
- "platform": "xiaohongshu",
- "channel": "social",
- "title": "小红书用户信息",
- "summary": "按 user_id 获取小红书用户资料(昵称、简介、粉丝/获赞等)。",
- "proxyPath": "xiaohongshu/app/get_user_info",
- "method": "GET",
- "paramsIn": "query",
- "tags": [
- "小红书",
- "xiaohongshu",
- "xhs",
- "用户",
- "user",
- "信息",
- "profile",
- "达人",
- "竞品"
- ],
- "params": [
- {
- "name": "user_id",
- "in": "query",
- "type": "string",
- "required": true,
- "desc": "用户 id(user_id),来自笔记/搜索返回。"
- }
- ],
- "responseHint": "返回用户资料对象,含粉丝数、获赞收藏、简介。"
- },
- {
- "id": "xiaohongshu.user_notes",
- "platform": "xiaohongshu",
- "channel": "social",
- "title": "小红书用户发布笔记",
- "summary": "按 user_id 拉取某用户发布的笔记列表,用于竞品/达人内容盘点。",
- "proxyPath": "xiaohongshu/app/get_user_notes",
- "method": "GET",
- "paramsIn": "query",
- "tags": [
- "小红书",
- "xiaohongshu",
- "xhs",
- "用户",
- "笔记",
- "notes",
- "posts",
- "竞品",
- "达人"
- ],
- "params": [
- {
- "name": "user_id",
- "in": "query",
- "type": "string",
- "required": true,
- "desc": "用户 id(user_id)。"
- },
- {
- "name": "cursor",
- "in": "query",
- "type": "string",
- "required": false,
- "default": "",
- "desc": "分页游标,首页留空,翻页用上一次返回的 cursor。"
- }
- ],
- "responseHint": "返回该用户的笔记列表;翻页用返回的 cursor。"
- },
- {
- "id": "xiaohongshu.topic_notes",
- "platform": "xiaohongshu",
- "channel": "social",
- "title": "小红书话题笔记",
- "summary": "按话题 page_id 拉取该话题下的笔记,用于话题/品类维度的 VOC 采集。",
- "proxyPath": "xiaohongshu/app/get_topic_notes",
- "method": "GET",
- "paramsIn": "query",
- "tags": [
- "小红书",
- "xiaohongshu",
- "xhs",
- "话题",
- "topic",
- "笔记",
- "品类",
- "voc"
- ],
- "params": [
- {
- "name": "page_id",
- "in": "query",
- "type": "string",
- "required": true,
- "desc": "话题 page_id。"
- },
- {
- "name": "first_load_time",
- "in": "query",
- "type": "string",
- "required": true,
- "desc": "首次加载时间戳(秒),首次请求传当前时间戳。"
- },
- {
- "name": "sort",
- "in": "query",
- "type": "string",
- "required": false,
- "default": "hot",
- "desc": "排序:hot 最热 / time 最新。"
- },
- {
- "name": "last_note_ct",
- "in": "query",
- "type": "string",
- "required": false,
- "default": "",
- "desc": "翻页透传上一次返回的 last_note_ct。"
- },
- {
- "name": "last_note_id",
- "in": "query",
- "type": "string",
- "required": false,
- "default": "",
- "desc": "翻页透传上一次返回的 last_note_id。"
- },
- {
- "name": "cursor_score",
- "in": "query",
- "type": "string",
- "required": false,
- "default": "",
- "desc": "翻页透传上一次返回的 cursor_score。"
- },
- {
- "name": "session_id",
- "in": "query",
- "type": "string",
- "required": false,
- "default": "",
- "desc": "翻页透传上一次返回的 session_id。"
- }
- ],
- "responseHint": "返回话题下笔记列表;翻页透传 last_note_ct/last_note_id/cursor_score/session_id。"
- },
- {
- "id": "xiaohongshu.search_products",
- "platform": "xiaohongshu",
- "channel": "social",
- "title": "小红书商品搜索",
- "summary": "按关键词搜索小红书商品(带价格/服务保障筛选),用于电商相关 VOC。",
- "proxyPath": "xiaohongshu/app/search_products",
- "method": "GET",
- "paramsIn": "query",
- "tags": [
- "小红书",
- "xiaohongshu",
- "xhs",
- "商品",
- "product",
- "电商",
- "搜索",
- "search"
- ],
- "params": [
- {
- "name": "keyword",
- "in": "query",
- "type": "string",
- "required": true,
- "desc": "搜索关键词。"
- },
- {
- "name": "page",
- "in": "query",
- "type": "integer",
- "required": true,
- "default": 1,
- "desc": "页码,从 1 开始。"
- },
- {
- "name": "sort",
- "in": "query",
- "type": "string",
- "required": false,
- "default": "",
- "desc": "排序方式,可留空用默认。"
- },
- {
- "name": "scope",
- "in": "query",
- "type": "string",
- "required": false,
- "default": "",
- "desc": "筛选范围,可留空。"
- },
- {
- "name": "min_price",
- "in": "query",
- "type": "string",
- "required": false,
- "default": "",
- "desc": "最低价筛选,可留空。"
- },
- {
- "name": "max_price",
- "in": "query",
- "type": "string",
- "required": false,
- "default": "",
- "desc": "最高价筛选,可留空。"
- },
- {
- "name": "search_id",
- "in": "query",
- "type": "string",
- "required": false,
- "default": "",
- "desc": "连续翻页时透传上一次返回的 search_id。"
- },
- {
- "name": "session_id",
- "in": "query",
- "type": "string",
- "required": false,
- "default": "",
- "desc": "连续翻页时透传上一次返回的 session_id。"
- }
- ],
- "responseHint": "返回商品列表,含标题、价格、销量、店铺。"
- }
- ]
- }
|