Data examples

Response format

Every endpoint answers in one envelope: request_id, data and meta, and meta says whether the call was billed and how much. Below are real responses, trimmed.

Field	Meaning
request_id	The call's ID, for billing questions and debugging
data	The data: posts, notes, videos and search results share one record shape; comments, profiles, reviews and creator data have their own
data.prov	Capture time, source (live or cache) and a checksum hash
meta.billed	Whether the call was billed; failures and empty results are not
meta.charged_usd	Amount charged for the call (USD)
meta.empty	Whether the result is empty

Cross-platform search Docs →

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
  }
}

Xiaohongshu note Docs →

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"
  }
}

Taobao & Tmall reviews Docs →

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"
  }
}

Your agent only knows what you give it

Give it Douyin, Xiaohongshu (RedNote), WeChat and product reviews: structured, per call, nothing charged for failures.

Get an API key Contact us