tihao-ai/claude-code-tihao-sourcing/mcp/catalog/voc-e-commerce-endpoints.json

{
  "version": "1.2.0",
  "updatedAt": "2026-07-03",
  "gateway": {
    "ecommerce": {
      "baseUrl": "https://server.fmode.cn/api/voc-e-commerce",
      "auth": "Authorization: Bearer <NewAPI fmode-api token（sk- 开头，优先）或平台 sessionToken（回退）>",
      "upstream": "公司 voc-e-commerce 代理，按 proxyPath 透传到电商达人数据上游，对外不暴露任何上游供应商名称。",
      "billing": "每次成功调用按平台规则计费一次；计费优先走 NewAPI（fmode-api）额度，sk- token 鉴权失败时自动回退平台 sessionToken。402=余额不足（引导 fmode-api 充值），401=token 缺失/失效，403=账号禁用/无权限。",
      "note": "这是一个通用转发网关：清单内已登记抖音/小红书达人搜索与详情接口；清单里没有的接口可直接用 tihao_api_call 传 rawPath + method + params 调用。",
      "rawPathHint": "调用未登记接口时，把 proxyPath 传给 tihao_api_call 的 rawPath，例如 douyin-xingtu/gw/api/data_sp/author_cp_info/v1，并按对应平台参数规则拼 query/body。"
    },
    "social": {
      "baseUrl": "https://server.fmode.cn/api/voc-social",
      "auth": "Authorization: Bearer <NewAPI fmode-api token（sk- 开头，优先）或平台 sessionToken（回退）>",
      "upstream": "公司 voc-social 中转网关（全量代理，按 proxyPath 透传到社媒数据上游），对外不暴露任何上游供应商名称。",
      "billing": "每次成功调用计费一次；计费与错误处理同电商网关（优先 fmode-api，401 回退 sessionToken）。",
      "note": "小红书素人/非蒲公英（笔记/用户/评论/话题搜索与详情）和抖音素人/开放端（用户/视频搜索、主页/作品/视频/评论详情、分享链接与主页链接解析、星图 kolId 转换）走这个网关。endpoint 带 channel=\"social\" 时 tihao_api_call 会自动选用本网关；未登记接口可传 rawPath + channel=\"social\" 调用。",
      "rawPathHint": "调用未登记的社媒接口时，把 proxyPath 传给 tihao_api_call 的 rawPath 并加 channel=\"social\"，例如 xiaohongshu/app/search_notes。"
    }
  },
  "platforms": [
    {
      "key": "douyin",
      "label": "抖音星图",
      "channel": "ecommerce",
      "status": "verified",
      "idField": "star_id",
      "detailParam": "oAuthorId"
    },
    {
      "key": "xiaohongshu",
      "label": "小红书蒲公英（PGY 商单博主）",
      "channel": "ecommerce",
      "status": "verified",
      "idField": "userId",
      "detailParam": "userId"
    },
    {
      "key": "xiaohongshu",
      "label": "小红书素人/非蒲公英（笔记·用户·评论）",
      "channel": "social",
      "status": "verified",
      "idField": "user_id",
      "detailParam": "user_id"
    },
    {
      "key": "douyin",
      "label": "抖音素人/开放端（搜索·主页·视频·评论·链接解析）",
      "channel": "social",
      "status": "verified",
      "idField": "sec_user_id",
      "detailParam": "sec_user_id"
    }
  ],
  "workflow": "电商达人（蒲公英/星图，channel=ecommerce）：第一波搜索拿达人 id（抖音 star_id、小红书 userId），第二波按需调详情接口补 CPM/CPE/商单/中位数。小红书素人/非蒲公英（channel=social，走 voc-social 全量代理）：用 xiaohongshu.search_notes 搜笔记、search/web_v3 搜用户，再用 note_detail/user_info/user_notes/note_comments 取详情。抖音素人/开放端（channel=social，同走 voc-social）：用 douyin.search_user / douyin.search_video 按关键词搜账号与视频；参考账号/参考视频解析用 douyin.get_sec_user_id（主页链接→sec_user_id）、douyin.fetch_one_video_by_share_url（分享链接→视频+作者），再用 douyin.user_profile / douyin.user_posts / douyin.video_detail / douyin.video_comments 补主页与近作证据；需要接回星图详情线时用 douyin.xingtu.get_xingtu_kolid_by_sec_user_id 或 get_xingtu_kolid_by_unique_id 把抖音账号换成星图 kolId。tihao_api_call 按 endpoint 的 channel 自动选网关；两条线计费都优先 NewAPI（fmode-api）sk- token，鉴权失败回退平台 sessionToken。",
  "endpoints": [
    {
      "id": "douyin.search_author_square",
      "platform": "douyin",
      "wave": "search",
      "title": "抖音星图达人广场搜索",
      "summary": "按关键词搜索抖音星图达人，返回达人列表（含 star_id、昵称、粉丝数、报价、标签等基础信息）。搜索结果不含 CPM/CPE/商单等绩效指标，需用详情接口补。返回项中的 star_id 即详情接口所需的 oAuthorId。",
      "method": "GET",
      "paramsIn": "query",
      "proxyPath": "douyin-xingtu/gw/api/gsearch/search_for_author_square/v1",
      "requiredParams": [
        "keyword"
      ],
      "responseHint": "data.model.itemList[]，每项含 star_id（→ oAuthorId）、name、follower、报价、标签。",
      "tags": [
        "抖音",
        "douyin",
        "星图",
        "搜索",
        "达人",
        "search",
        "first-wave"
      ],
      "billing": 1,
      "channel": "ecommerce"
    },
    {
      "id": "douyin.author_cp_info",
      "platform": "douyin",
      "wave": "detail",
      "title": "抖音星图达人 CPM/CPE 预期",
      "summary": "返回单个达人的图文/视频预期 CPM、CPE、预期播放等投放性价比指标。入参 oAuthorId 取自搜索结果的 star_id。",
      "method": "GET",
      "paramsIn": "query",
      "proxyPath": "douyin-xingtu/gw/api/data_sp/author_cp_info/v1",
      "requiredParams": [
        "oAuthorId"
      ],
      "responseHint": "expect_cpm / expect_cpe / expect_vv / hot_item 等预期投放指标。",
      "tags": [
        "抖音",
        "douyin",
        "星图",
        "cpm",
        "cpe",
        "详情",
        "detail",
        "second-wave",
        "绩效"
      ],
      "billing": 1,
      "channel": "ecommerce"
    },
    {
      "id": "douyin.author_convert_ability",
      "platform": "douyin",
      "wave": "detail",
      "title": "抖音星图达人转化能力",
      "summary": "返回单个达人的 GPM 区间、视频播放中位数、关联视频数、推荐商品数等转化能力指标。入参 oAuthorId 取自搜索结果的 star_id。",
      "method": "GET",
      "paramsIn": "query",
      "proxyPath": "douyin-xingtu/gw/api/data_sp/get_author_convert_ability/v1",
      "requiredParams": [
        "oAuthorId"
      ],
      "responseHint": "gpm_range / video_vv_median（播放中位数）/ related_video_cnt / rec_product_cnt 等。",
      "tags": [
        "抖音",
        "douyin",
        "星图",
        "转化",
        "中位数",
        "gpm",
        "详情",
        "detail",
        "second-wave",
        "绩效"
      ],
      "billing": 1,
      "channel": "ecommerce"
    },
    {
      "id": "douyin.author_marketing_info",
      "platform": "douyin",
      "wave": "detail",
      "title": "抖音星图达人营销/报价信息",
      "summary": "返回单个达人的分时长报价、行业标签、活动信息、榜单排名等营销信息。入参 oAuthorId 取自搜索结果的 star_id。",
      "method": "GET",
      "paramsIn": "query",
      "proxyPath": "douyin-xingtu/gw/api/author/get_author_marketing_info/v1",
      "requiredParams": [
        "oAuthorId"
      ],
      "responseHint": "price_info[]（分时长报价）/ industry_tags / activity_info / hot_list_ranks。",
      "tags": [
        "抖音",
        "douyin",
        "星图",
        "报价",
        "营销",
        "标签",
        "详情",
        "detail",
        "second-wave"
      ],
      "billing": 1,
      "channel": "ecommerce"
    },
    {
      "id": "douyin.author_order_experience",
      "platform": "douyin",
      "wave": "detail",
      "title": "抖音星图达人商单/合作经验",
      "summary": "返回单个达人的商单合作行业经验等指标，可用于推断商单数/合作活跃度。入参 oAuthorId 取自搜索结果的 star_id。",
      "method": "GET",
      "paramsIn": "query",
      "proxyPath": "douyin-xingtu/gw/api/aggregator/get_author_order_experience/v1",
      "requiredParams": [
        "oAuthorId"
      ],
      "responseHint": "order_experience_industries[]（商单合作行业经验）。",
      "tags": [
        "抖音",
        "douyin",
        "星图",
        "商单",
        "合作",
        "经验",
        "详情",
        "detail",
        "second-wave"
      ],
      "billing": 1,
      "channel": "ecommerce"
    },
    {
      "id": "douyin.search_user",
      "platform": "douyin",
      "channel": "social",
      "wave": "search",
      "title": "抖音用户搜索",
      "summary": "按关键词搜索抖音用户/账号（素人/开放端，非星图）。用于按行业词/账号名找抖音达人或对照参考账号。返回的 sec_user_id 可继续用于 user_profile / user_posts / 星图 kolId 转换。",
      "method": "POST",
      "paramsIn": "body",
      "proxyPath": "douyin/search/fetch_user_search_v2",
      "requiredParams": [
        "keyword"
      ],
      "params": [
        {
          "name": "keyword",
          "in": "body",
          "type": "string",
          "required": true,
          "desc": "搜索关键词（账号名/行业词），如「港风穿搭」「母婴测评」。"
        },
        {
          "name": "cursor",
          "in": "body",
          "type": "integer",
          "required": false,
          "default": 0,
          "desc": "分页偏移游标，首页为 0，翻页用上一次返回的 cursor。"
        },
        {
          "name": "search_id",
          "in": "body",
          "type": "string",
          "required": false,
          "default": "",
          "desc": "连续翻页时透传上一次返回的 search_id。"
        }
      ],
      "responseHint": "返回用户列表，含 sec_user_id、昵称、粉丝数、抖音号（unique_id）；sec_user_id 用于主页/作品接口，unique_id 可换星图 kolId。",
      "tags": [
        "抖音",
        "douyin",
        "素人",
        "非星图",
        "社媒",
        "social",
        "用户",
        "user",
        "账号",
        "搜索",
        "search",
        "达人",
        "kol"
      ],
      "billing": 1
    },
    {
      "id": "douyin.search_video",
      "platform": "douyin",
      "channel": "social",
      "wave": "search",
      "title": "抖音视频搜索",
      "summary": "按关键词只搜索抖音视频（素人/开放端）。用于按方向词采集相关短视频、找同类内容账号。",
      "method": "POST",
      "paramsIn": "body",
      "proxyPath": "douyin/search/fetch_video_search_v2",
      "requiredParams": [
        "keyword"
      ],
      "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": "search_id",
          "in": "body",
          "type": "string",
          "required": false,
          "default": "",
          "desc": "连续翻页时透传上一次返回的 search_id。"
        }
      ],
      "responseHint": "返回视频列表，含 aweme_id、作者（含 sec_user_id）、统计数据；翻页用 cursor/search_id。",
      "tags": [
        "抖音",
        "douyin",
        "素人",
        "非星图",
        "社媒",
        "social",
        "视频",
        "video",
        "搜索",
        "search",
        "关键词"
      ],
      "billing": 1
    },
    {
      "id": "douyin.search_general",
      "platform": "douyin",
      "channel": "social",
      "wave": "search",
      "title": "抖音综合搜索",
      "summary": "按关键词做抖音综合搜索（视频/用户/话题混合，素人/开放端）。搜索意图不确定时的入口。",
      "method": "POST",
      "paramsIn": "body",
      "proxyPath": "douyin/search/fetch_general_search_v2",
      "requiredParams": [
        "keyword"
      ],
      "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": "search_id",
          "in": "body",
          "type": "string",
          "required": false,
          "default": "",
          "desc": "连续翻页时透传上一次返回的 search_id。"
        }
      ],
      "responseHint": "返回混合结果（视频/用户/话题）；翻页用 cursor/search_id。",
      "tags": [
        "抖音",
        "douyin",
        "素人",
        "非星图",
        "社媒",
        "social",
        "综合",
        "搜索",
        "search",
        "视频",
        "用户"
      ],
      "billing": 1
    },
    {
      "id": "douyin.user_profile",
      "platform": "douyin",
      "channel": "social",
      "wave": "detail",
      "title": "抖音用户主页信息",
      "summary": "按 sec_user_id 获取抖音用户主页资料（昵称、签名、粉丝/获赞/作品数等）。参考账号解析与候选账号主页补证用。",
      "method": "GET",
      "paramsIn": "query",
      "proxyPath": "douyin/app/v3/handler_user_profile",
      "requiredParams": [
        "sec_user_id"
      ],
      "params": [
        {
          "name": "sec_user_id",
          "in": "query",
          "type": "string",
          "required": true,
          "desc": "用户 sec_user_id，来自 search_user、视频作者字段或 get_sec_user_id 链接解析。"
        }
      ],
      "responseHint": "返回用户资料对象，含粉丝数、获赞数、作品数、签名、抖音号（unique_id）。",
      "tags": [
        "抖音",
        "douyin",
        "素人",
        "非星图",
        "社媒",
        "social",
        "用户",
        "user",
        "主页",
        "profile",
        "参考账号",
        "达人"
      ],
      "billing": 1
    },
    {
      "id": "douyin.user_posts",
      "platform": "douyin",
      "channel": "social",
      "wave": "detail",
      "title": "抖音用户发布视频",
      "summary": "按 sec_user_id 拉取某用户主页发布的视频列表。用于参考账号/候选账号近作盘点（近 10-20 条、更新频率、内容类目一致性）。",
      "method": "GET",
      "paramsIn": "query",
      "proxyPath": "douyin/app/v3/fetch_user_post_videos",
      "requiredParams": [
        "sec_user_id"
      ],
      "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。"
        }
      ],
      "responseHint": "返回该用户的视频列表（含 aweme_id、标题、封面、统计）；翻页用返回的 max_cursor。",
      "tags": [
        "抖音",
        "douyin",
        "素人",
        "非星图",
        "社媒",
        "social",
        "用户",
        "作品",
        "posts",
        "近作",
        "参考账号",
        "达人"
      ],
      "billing": 1
    },
    {
      "id": "douyin.video_detail",
      "platform": "douyin",
      "channel": "social",
      "wave": "detail",
      "title": "抖音视频详情",
      "summary": "按视频 id（aweme_id）获取单个抖音视频完整数据（标题、作者、统计、视频地址、封面等）。参考视频补证用。",
      "method": "GET",
      "paramsIn": "query",
      "proxyPath": "douyin/app/v3/fetch_one_video",
      "requiredParams": [
        "aweme_id"
      ],
      "params": [
        {
          "name": "aweme_id",
          "in": "query",
          "type": "string",
          "required": true,
          "desc": "视频 id（aweme_id），来自搜索/作品列表/链接解析。"
        }
      ],
      "responseHint": "返回单个视频对象，含统计、作者（sec_user_id）、话题、视频/封面地址。",
      "tags": [
        "抖音",
        "douyin",
        "素人",
        "非星图",
        "社媒",
        "social",
        "视频",
        "video",
        "详情",
        "detail",
        "参考视频",
        "aweme"
      ],
      "billing": 1
    },
    {
      "id": "douyin.video_comments",
      "platform": "douyin",
      "channel": "social",
      "wave": "detail",
      "title": "抖音视频评论列表",
      "summary": "按视频 id 拉取抖音视频一级评论。用于互动真实性核查（重复评论/刷评风险）与口碑证据。",
      "method": "GET",
      "paramsIn": "query",
      "proxyPath": "douyin/app/v3/fetch_video_comments",
      "requiredParams": [
        "aweme_id"
      ],
      "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。",
      "tags": [
        "抖音",
        "douyin",
        "素人",
        "非星图",
        "社媒",
        "social",
        "评论",
        "comment",
        "刷评",
        "互动",
        "风险"
      ],
      "billing": 1
    },
    {
      "id": "douyin.get_sec_user_id",
      "platform": "douyin",
      "channel": "social",
      "wave": "resolve",
      "title": "抖音主页链接提取 sec_user_id",
      "summary": "把抖音用户主页链接（含短链）解析成 sec_user_id。参考账号链接解析第一步。",
      "method": "GET",
      "paramsIn": "query",
      "proxyPath": "douyin/web/get_sec_user_id",
      "requiredParams": [
        "url"
      ],
      "params": [
        {
          "name": "url",
          "in": "query",
          "type": "string",
          "required": true,
          "desc": "用户主页链接，支持 v.douyin.com 短链与 www.douyin.com/user/ 长链。"
        }
      ],
      "responseHint": "返回 sec_user_id，可继续调 user_profile / user_posts / 星图 kolId 转换。",
      "tags": [
        "抖音",
        "douyin",
        "素人",
        "非星图",
        "社媒",
        "social",
        "链接解析",
        "参考账号",
        "sec_user_id",
        "短链",
        "主页"
      ],
      "billing": 1
    },
    {
      "id": "douyin.fetch_one_video_by_share_url",
      "platform": "douyin",
      "channel": "social",
      "wave": "resolve",
      "title": "抖音分享链接获取视频数据",
      "summary": "按抖音分享链接（含 v.douyin.com 短链）直接获取该视频完整数据。参考视频链接解析一步到位（视频+作者 sec_user_id）。",
      "method": "GET",
      "paramsIn": "query",
      "proxyPath": "douyin/app/v3/fetch_one_video_by_share_url",
      "requiredParams": [
        "share_url"
      ],
      "params": [
        {
          "name": "share_url",
          "in": "query",
          "type": "string",
          "required": true,
          "desc": "视频分享链接，支持短链。"
        }
      ],
      "responseHint": "返回单个视频对象（同 video_detail），含作者 sec_user_id，可继续做账号解析。",
      "tags": [
        "抖音",
        "douyin",
        "素人",
        "非星图",
        "社媒",
        "social",
        "链接解析",
        "参考视频",
        "分享链接",
        "短链",
        "video"
      ],
      "billing": 1
    },
    {
      "id": "douyin.xingtu.get_xingtu_kolid_by_sec_user_id",
      "platform": "douyin",
      "channel": "social",
      "wave": "resolve",
      "title": "sec_user_id 换星图 kolId",
      "summary": "通过抖音 sec_user_id 获取星图 kolId。把素人线解析出的参考账号接回星图详情线（报价/CP/商单等）。",
      "method": "GET",
      "paramsIn": "query",
      "proxyPath": "douyin/xingtu/get_xingtu_kolid_by_sec_user_id",
      "requiredParams": [
        "sec_user_id"
      ],
      "params": [
        {
          "name": "sec_user_id",
          "in": "query",
          "type": "string",
          "required": true,
          "desc": "抖音用户 sec_user_id。"
        }
      ],
      "responseHint": "返回星图 kolId；拿到后可用星图详情接口（oAuthorId=kolId）查报价/CP/商单数据。",
      "tags": [
        "抖音",
        "douyin",
        "素人",
        "非星图",
        "社媒",
        "social",
        "星图",
        "xingtu",
        "kolid",
        "参考账号",
        "桥接"
      ],
      "billing": 1
    },
    {
      "id": "douyin.xingtu.get_xingtu_kolid_by_unique_id",
      "platform": "douyin",
      "channel": "social",
      "wave": "resolve",
      "title": "抖音号换星图 kolId",
      "summary": "通过抖音号（unique_id）获取星图 kolId。客户只给抖音号时直接接回星图详情线。",
      "method": "GET",
      "paramsIn": "query",
      "proxyPath": "douyin/xingtu/get_xingtu_kolid_by_unique_id",
      "requiredParams": [
        "unique_id"
      ],
      "params": [
        {
          "name": "unique_id",
          "in": "query",
          "type": "string",
          "required": true,
          "desc": "抖音号（unique_id）。"
        }
      ],
      "responseHint": "返回星图 kolId；拿到后可用星图详情接口（oAuthorId=kolId）查报价/CP/商单数据。",
      "tags": [
        "抖音",
        "douyin",
        "素人",
        "非星图",
        "社媒",
        "social",
        "星图",
        "xingtu",
        "kolid",
        "抖音号",
        "桥接"
      ],
      "billing": 1
    },
    {
      "id": "xiaohongshu.search_blogger",
      "platform": "xiaohongshu",
      "wave": "search",
      "title": "小红书蒲公英博主搜索",
      "summary": "按关键词搜索小红书蒲公英博主，返回博主列表（含 userId、redId 短ID、昵称、粉丝数、报价及部分绩效字段）。返回项中的 userId 即详情接口所需入参。",
      "method": "GET",
      "paramsIn": "query",
      "proxyPath": "xiaohongshu-pgy/api/solar/cooperator/blogger/v2/v1",
      "requiredParams": [
        "keyword"
      ],
      "responseHint": "博主列表，每项含 userId（→ 详情接口入参）、redId（短ID）、昵称、粉丝数、报价、部分 CPM/互动字段。",
      "tags": [
        "小红书",
        "xiaohongshu",
        "蒲公英",
        "pgy",
        "搜索",
        "博主",
        "search",
        "first-wave"
      ],
      "billing": 1,
      "channel": "ecommerce"
    },
    {
      "id": "xiaohongshu.kol_cost_effective",
      "platform": "xiaohongshu",
      "wave": "detail",
      "title": "小红书蒲公英博主性价比 (CPM/CPE)",
      "summary": "返回单个博主的图文/视频预期 CPM、阅读成本、互动成本等性价比指标。入参 userId 取自搜索结果。",
      "method": "GET",
      "paramsIn": "query",
      "proxyPath": "xiaohongshu-pgy/api/solar/kol/dataV2/costEffective/v1",
      "requiredParams": [
        "userId"
      ],
      "responseHint": "estimatePictureCpm / estimateVideoCpm / pictureReadCost / videoReadCost / estimatePictureEngageCost 等。",
      "tags": [
        "小红书",
        "xiaohongshu",
        "蒲公英",
        "pgy",
        "cpm",
        "cpe",
        "性价比",
        "详情",
        "detail",
        "second-wave",
        "绩效"
      ],
      "billing": 1,
      "channel": "ecommerce"
    },
    {
      "id": "xiaohongshu.kol_core_data",
      "platform": "xiaohongshu",
      "wave": "detail",
      "title": "小红书蒲公英博主核心数据",
      "summary": "返回单个博主的核心数据（阅读/互动中位数等汇总与每日数据）。入参 userId 取自搜索结果。",
      "method": "GET",
      "paramsIn": "query",
      "proxyPath": "xiaohongshu-pgy/api/pgy/kol/data/core_data/v1",
      "requiredParams": [
        "userId"
      ],
      "responseHint": "sumData（阅读/互动中位数等汇总）/ dailyData（每日数据）。",
      "tags": [
        "小红书",
        "xiaohongshu",
        "蒲公英",
        "pgy",
        "核心数据",
        "中位数",
        "详情",
        "detail",
        "second-wave",
        "绩效"
      ],
      "billing": 1,
      "channel": "ecommerce"
    },
    {
      "id": "xiaohongshu.search_notes",
      "platform": "xiaohongshu",
      "channel": "social",
      "wave": "search",
      "title": "小红书笔记搜索",
      "summary": "按关键词搜索小红书笔记。任意行业/方向关键词均可用于 VOC 选题与口碑采集。",
      "method": "GET",
      "paramsIn": "query",
      "proxyPath": "xiaohongshu/app/search_notes",
      "requiredParams": [
        "keyword",
        "page"
      ],
      "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。",
      "tags": [
        "小红书",
        "xiaohongshu",
        "xhs",
        "笔记",
        "note",
        "搜索",
        "search",
        "关键词",
        "voc",
        "素人",
        "非蒲公英",
        "社媒",
        "social"
      ],
      "billing": 1
    },
    {
      "id": "xiaohongshu.search_products",
      "platform": "xiaohongshu",
      "channel": "social",
      "wave": "search",
      "title": "小红书商品搜索",
      "summary": "按关键词搜索小红书商品（带价格/服务保障筛选），用于电商相关 VOC。",
      "method": "GET",
      "paramsIn": "query",
      "proxyPath": "xiaohongshu/app/search_products",
      "requiredParams": [
        "keyword",
        "page"
      ],
      "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": "返回商品列表，含标题、价格、销量、店铺。",
      "tags": [
        "小红书",
        "xiaohongshu",
        "xhs",
        "商品",
        "product",
        "电商",
        "搜索",
        "search",
        "素人",
        "非蒲公英",
        "社媒",
        "social"
      ],
      "billing": 1
    },
    {
      "id": "xiaohongshu.web_v3.fetch_search_notes",
      "platform": "xiaohongshu",
      "channel": "social",
      "wave": "search",
      "title": "搜索笔记",
      "summary": "搜索笔记 接口优先级: - 小红书接口推荐优先级: `App V2` > `App` > `Web V3（本接口）` > `Web V2` > `Web` 参数: - keyword: 搜索关键词 - page: 页码 - sort: 排序方式 - general: 综合 - t",
      "method": "GET",
      "paramsIn": "query",
      "proxyPath": "xiaohongshu/web_v3/fetch_search_notes",
      "requiredParams": [],
      "params": [],
      "responseHint": "",
      "tags": [
        "xiaohongshu",
        "小红书",
        "web",
        "v3",
        "素人",
        "非蒲公英",
        "社媒",
        "social"
      ],
      "billing": 1
    },
    {
      "id": "xiaohongshu.web_v3.fetch_search_users",
      "platform": "xiaohongshu",
      "channel": "social",
      "wave": "search",
      "title": "搜索用户",
      "summary": "搜索用户 接口优先级: - 小红书接口推荐优先级: `App V2` > `App` > `Web V3（本接口）` > `Web V2` > `Web` 参数: - keyword: 搜索关键词 - page: 页码",
      "method": "GET",
      "paramsIn": "query",
      "proxyPath": "xiaohongshu/web_v3/fetch_search_users",
      "requiredParams": [],
      "params": [],
      "responseHint": "",
      "tags": [
        "xiaohongshu",
        "小红书",
        "web",
        "v3",
        "素人",
        "非蒲公英",
        "社媒",
        "social"
      ],
      "billing": 1
    },
    {
      "id": "xiaohongshu.note_detail",
      "platform": "xiaohongshu",
      "channel": "social",
      "wave": "detail",
      "title": "小红书笔记详情",
      "summary": "按 note_id（或分享文案）获取小红书笔记完整内容。",
      "method": "GET",
      "paramsIn": "query",
      "proxyPath": "xiaohongshu/app/get_note_info",
      "requiredParams": [
        "note_id"
      ],
      "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": "返回单条笔记对象，含正文、图片/视频、话题、互动数。",
      "tags": [
        "小红书",
        "xiaohongshu",
        "xhs",
        "笔记",
        "note",
        "详情",
        "detail",
        "素人",
        "非蒲公英",
        "社媒",
        "social"
      ],
      "billing": 1
    },
    {
      "id": "xiaohongshu.note_comments",
      "platform": "xiaohongshu",
      "channel": "social",
      "wave": "detail",
      "title": "小红书笔记评论",
      "summary": "按 note_id 拉取小红书笔记的一级评论（App V2，VOC 口碑主力接口）。",
      "method": "GET",
      "paramsIn": "query",
      "proxyPath": "xiaohongshu/app_v2/get_note_comments",
      "requiredParams": [
        "note_id"
      ],
      "params": [
        {
          "name": "note_id",
          "in": "query",
          "type": "string",
          "required": true,
          "desc": "笔记 id（note_id），来自 search_notes 返回的 note.id。"
        },
        {
          "name": "share_text",
          "in": "query",
          "type": "string",
          "required": false,
          "default": "",
          "desc": "可选：小红书分享文案/链接，与 note_id 二选一。"
        },
        {
          "name": "xsec_token",
          "in": "query",
          "type": "string",
          "required": false,
          "default": "",
          "desc": "可选安全令牌，来自 search_notes 返回的 note.xsec_token；部分笔记风控需要。"
        }
      ],
      "responseHint": "返回评论列表，含 comment_id、文本、点赞、子评论数；翻页用返回的游标。",
      "tags": [
        "小红书",
        "xiaohongshu",
        "xhs",
        "评论",
        "comment",
        "voc",
        "口碑",
        "素人",
        "非蒲公英",
        "社媒",
        "social"
      ],
      "billing": 1
    },
    {
      "id": "xiaohongshu.sub_comments",
      "platform": "xiaohongshu",
      "channel": "social",
      "wave": "detail",
      "title": "小红书评论回复（楼中楼）",
      "summary": "按 note_id + comment_id 拉取某条评论下的回复（App V2），用于深挖讨论。",
      "method": "GET",
      "paramsIn": "query",
      "proxyPath": "xiaohongshu/app_v2/get_note_sub_comments",
      "requiredParams": [
        "note_id",
        "comment_id"
      ],
      "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。",
      "tags": [
        "小红书",
        "xiaohongshu",
        "xhs",
        "评论",
        "回复",
        "reply",
        "sub",
        "楼中楼",
        "voc",
        "素人",
        "非蒲公英",
        "社媒",
        "social"
      ],
      "billing": 1
    },
    {
      "id": "xiaohongshu.user_info",
      "platform": "xiaohongshu",
      "channel": "social",
      "wave": "detail",
      "title": "小红书用户信息",
      "summary": "按 user_id 获取小红书用户资料（昵称、简介、粉丝/获赞等）。",
      "method": "GET",
      "paramsIn": "query",
      "proxyPath": "xiaohongshu/app/get_user_info",
      "requiredParams": [
        "user_id"
      ],
      "params": [
        {
          "name": "user_id",
          "in": "query",
          "type": "string",
          "required": true,
          "desc": "用户 id（24 位 hex），来自 search_notes 返回的 note.user.userid；注意不是数字 red_id。"
        }
      ],
      "responseHint": "返回用户资料对象，含粉丝数、获赞收藏、简介。",
      "tags": [
        "小红书",
        "xiaohongshu",
        "xhs",
        "用户",
        "user",
        "信息",
        "profile",
        "达人",
        "竞品",
        "素人",
        "非蒲公英",
        "社媒",
        "social"
      ],
      "billing": 1
    },
    {
      "id": "xiaohongshu.user_notes",
      "platform": "xiaohongshu",
      "channel": "social",
      "wave": "detail",
      "title": "小红书用户发布笔记",
      "summary": "按 user_id 拉取某用户发布的笔记列表，用于竞品/达人内容盘点。",
      "method": "GET",
      "paramsIn": "query",
      "proxyPath": "xiaohongshu/app/get_user_notes",
      "requiredParams": [
        "user_id"
      ],
      "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。",
      "tags": [
        "小红书",
        "xiaohongshu",
        "xhs",
        "用户",
        "笔记",
        "notes",
        "posts",
        "竞品",
        "达人",
        "素人",
        "非蒲公英",
        "社媒",
        "social"
      ],
      "billing": 1
    },
    {
      "id": "xiaohongshu.topic_notes",
      "platform": "xiaohongshu",
      "channel": "social",
      "wave": "detail",
      "title": "小红书话题笔记",
      "summary": "按话题 page_id 拉取该话题下的笔记，用于话题/品类维度的 VOC 采集。",
      "method": "GET",
      "paramsIn": "query",
      "proxyPath": "xiaohongshu/app/get_topic_notes",
      "requiredParams": [
        "page_id",
        "first_load_time"
      ],
      "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。",
      "tags": [
        "小红书",
        "xiaohongshu",
        "xhs",
        "话题",
        "topic",
        "笔记",
        "品类",
        "voc",
        "素人",
        "非蒲公英",
        "社媒",
        "social"
      ],
      "billing": 1
    },
    {
      "id": "xiaohongshu.web_v3.fetch_user_info",
      "platform": "xiaohongshu",
      "channel": "social",
      "wave": "detail",
      "title": "获取用户信息",
      "summary": "获取用户公开资料 接口优先级: - 小红书接口推荐优先级: `App V2` > `App` > `Web V3（本接口）` > `Web V2` > `Web` 参数: - user_id: 用户ID",
      "method": "GET",
      "paramsIn": "query",
      "proxyPath": "xiaohongshu/web_v3/fetch_user_info",
      "requiredParams": [],
      "params": [],
      "responseHint": "",
      "tags": [
        "xiaohongshu",
        "小红书",
        "web",
        "v3",
        "素人",
        "非蒲公英",
        "社媒",
        "social"
      ],
      "billing": 1
    },
    {
      "id": "xiaohongshu.web_v3.fetch_user_notes",
      "platform": "xiaohongshu",
      "channel": "social",
      "wave": "detail",
      "title": "获取用户笔记列表",
      "summary": "获取用户发布的笔记列表 接口优先级: - 小红书接口推荐优先级: `App V2` > `App` > `Web V3（本接口）` > `Web V2` > `Web` 参数: - user_id: 用户ID - cursor: 翻页游标 - num: 返回数量 (最大 30)",
      "method": "GET",
      "paramsIn": "query",
      "proxyPath": "xiaohongshu/web_v3/fetch_user_notes",
      "requiredParams": [],
      "params": [],
      "responseHint": "",
      "tags": [
        "xiaohongshu",
        "小红书",
        "web",
        "v3",
        "素人",
        "非蒲公英",
        "社媒",
        "social"
      ],
      "billing": 1
    },
    {
      "id": "xiaohongshu.web_v3.fetch_note_detail",
      "platform": "xiaohongshu",
      "channel": "social",
      "wave": "detail",
      "title": "获取笔记详情",
      "summary": "获取笔记详情（图文/视频通用） 接口优先级: - 小红书接口推荐优先级: `App V2` > `App` > `Web V3（本接口）` > `Web V2` > `Web` 参数: - note_id: 笔记ID，可以从小红书的分享链接中获取 - xsec_token: 安全",
      "method": "GET",
      "paramsIn": "query",
      "proxyPath": "xiaohongshu/web_v3/fetch_note_detail",
      "requiredParams": [],
      "params": [],
      "responseHint": "",
      "tags": [
        "xiaohongshu",
        "小红书",
        "web",
        "v3",
        "素人",
        "非蒲公英",
        "社媒",
        "social"
      ],
      "billing": 1
    }
  ]
}