数据样例

返回格式

所有接口都返回同一个外壳:request_id、data、meta,meta 里写明这次是否扣费、扣了多少。下面是真实接口的返回示例,内容做了截断。

字段说明
request_id这次调用的编号,对账和排查问题都用它
data返回的数据;帖子、笔记、视频和搜索结果用同一套记录结构,评论、资料、商品评价和达人数据按各自的结构返回
data.prov采集时间、来源(实时或缓存)和校验哈希
meta.billed这次是否扣费;失败和空结果不扣
meta.charged_usd本次扣费金额(美元)
meta.empty结果是否为空

跨平台检索 文档 →

POST /v1/searchprov
{
  "request_id": "00000000-0000-0000-0000-000000000000",
  "data": {
    "items": [
      {
        "id": "soc_wei_e32e9c5a0c8f",
        "platform": "weibo",
        "site": "微博",
        "text": "“‘念PPT’其背后折射出的更多是教学态度、教学效果和课堂互动方面的问题。”…",
        "url": "http://weibo.com/1700648435/RnISydWJo",
        "published_at": "2026-10-21T19:31:06+08:00",
        "type": "original",
        "sentiment": "neutral",
        "author": {
          "name": "成都商报",
          "followers": 25329072
        },
        "metrics": {
          "views": 324
        }
      }
    ],
    "total": 1966273,
    "by_platform": {
      "weibo": 119048,
      "douyin": 380189,
      "xiaohongshu": 52024,
      "wechat": 234572,
      "news": 589995
    },
    "has_more": true,
    "prov": {
      "hash": "0xb0ecb783f9c747ec",
      "ts": "2026-10-21T19:35:00+08:00",
      "source": "live"
    }
  },
  "meta": {
    "billed": true,
    "charged_usd": "0.005000",
    "empty": false
  }
}

小红书笔记详情 文档 →

GET /v1/raw/xiaohongshu/noteprov
{
  "id": "soc_xia_456d9ed67d8b",
  "platform": "xiaohongshu",
  "text": "高三后期,班里开始靠咖啡续命了…",
  "author": {
    "nickname": "说***吗"
  },
  "metrics": {
    "likes": 11045,
    "comments": 1072,
    "saves": 1153,
    "shares": 359
  },
  "extra": {
    "note_type": "image",
    "topic": "#晚自习",
    "published_at": "2026-05-26T01:18:37+08:00",
    "ip_location": "山东"
  },
  "prov": {
    "hash": "0x9bfd99f0f6635fc6",
    "ts": "2026-10-21T20:49:50+08:00",
    "source": "live"
  }
}

淘宝/天猫商品评价 文档 →

GET /v1/raw/taobao/commentsprov
{
  "items": [
    {
      "id": "eco_tao_9b5c72573494",
      "text": "我觉得性价比一般,有点贵。效果还可以",
      "rating_level": "good",
      "created_at": "2026-10-14T21:08:00+08:00",
      "sku": "套餐类型:1盒装",
      "followup": null
    }
  ],
  "total": 400,
  "has_more": true,
  "prov": {
    "hash": "0x7b921e36e8cf1b4c",
    "ts": "2026-10-21T19:59:04+08:00",
    "source": "live"
  }
}

你的 Agent 能看到什么,取决于你给它什么数据

把抖音、小红书、公众号和电商评价交给它:结构化,按次计费,失败不扣费。