蒲公英(小红书) · 达人营销

笔记报告

传入笔记 ID 或笔记链接,每篇笔记返回一条记录,含标题、日期、曝光、阅读数、点赞数、收藏数、评论数和分享数。

POST/v1/pugongying/noteReport

$0.06每条

1,000 条
≈ $60.00
每取一条最低
$0.025213

只能用充值余额一次返回,没有 cursor

在控制台里试

怎么发

用 POST 带 JSON 请求体,或者用 GET 把同样的参数放进查询串。key 放在 Authorization 头里。

curl -X POST "https://api.silklinedata.com/v1/pugongying/noteReport" \
  -H "Authorization: Bearer $SILKLINE_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit":5,"notes":["6ad99263000000002c011c49"]}'

返回什么

这是 2026-11-09 一次真实请求返回的记录。普通用户的名字、头像和主页链接显示为 <masked>;长文字只在这里截短,接口里是完整的。

200 OK · 取数日期 2026-11-09
{
  "data": [
    {
      "type": "noteReport",
      "noteId": "6ad99263000000002c011c49",
      "url": "https://www.xiaohongshu.com/explore/6…",
      "userId": "<masked>",
      "nickname": "<masked>",
      "redId": null,
      "followers": 186646,
      "title": "拉花第二人机怎么拍",
      "content": "#咖啡拉花[话题]# #咖啡拉花挑战[话题]#",
      "date": "2026-10-22 12:34",
      "isVideo": true,
      "imageUrls": [
        "http://ci.xiaohongshu.com/1040g2sg326…"
      ],
      "videoUrl": "http://v.xiaohongshu.com/stream/79/11…",
      "videoDurationS": 21,
      "impressions": 4838,
      "readNum": 911,
      "likeNum": 41,
      "collectNum": 4,
      "commentNum": 2,
      "shareNum": 1,
      "followsGained": 0,
      "brandName": null,
      "featureTags": [],
      "noteContentComponent": null,
      "noteBottomComponent": null,
      "noteCommentComponent": null
    }
  ],
  "cursor": null,
  "meta": {
    "request_id": "req_01JD8Q…",
    "charged_usd": "0.060000",
    "balance_usd": "9.875000",
    "items": 1
  }
}

字段 26

字段类型示例值
typestringnoteReport
noteIdstring6ad99263000000002c011c49
urlstringhttps://www.xiaohongshu.com/explore/6ad99263000000002c011c49
userIdstring<masked>
nicknamestring<masked>
redIdnullnull
followersnumber186646
titlestring拉花第二人机怎么拍
contentstring#咖啡拉花[话题]# #咖啡拉花挑战[话题]#
datestring2026-10-22 12:34
isVideobooleantrue
imageUrlsarray["http://ci.xiaohongshu.com/1040g2sg326k5b43o507049un6vtua2o…
videoUrlstringhttp://v.xiaohongshu.com/stream/79/110/258/01ead992635d80904…
videoDurationSnumber21
impressionsnumber4838
readNumnumber911
likeNumnumber41
collectNumnumber4
commentNumnumber2
shareNumnumber1
followsGainednumber0
brandNamenullnull
featureTagsarray[]
noteContentComponentnullnull
noteBottomComponentnullnull
noteCommentComponentnullnull

参数 2

参数名类型必填说明示例
limitinteger否返回的记录条数,1 到 100。一次请求返回的条数不会超过这个值。5
notesarray是笔记 ID(24 位字符)或小红书笔记链接,例如 https://www.xiaohongshu.com/explore/6ad99263000000002c011c49。每个条目对应一份笔记报告。["6ad99263000000002c011c49"]

翻页

这个接口一次请求就返回全部:要更多条就把 limit 调大(最多 100)。cursor 一直是 null。

一次请求花多少

按条计费;一次请求条数少或没有结果时,每取一页收费不超过这个接口每页的最低收费,可能更低;我们这边出错或超时不收费。

这个接口每条单独取,每取一条的最低收费是 $0.025213。

  • 1 条:最多 $0.06
  • 20 条:最多 $1.20
  • 100 条:最多 $6.00

返回的 meta 里写着这次扣了多少(charged_usd)和还剩多少(balance_usd)。我们这边出错不收费。

常见问题

「笔记报告」要传哪些参数?

必填:notes。另外都可以传 limit(1 到 100)。

一次请求最多返回多少条?

每次请求最多 100 条(limit 1 到 100)。每页最多 1 条,要 100 条时一次请求取 100 页。

能接着往后取吗?

不能。这个接口一次请求就把结果全部返回,回答里的 cursor 是 null。

怎么收费?

每条 详情记录 $0.06。每页最低收费 $0.025213:条数少或没有结果时,每取一页最多收这么多,可能更低。取 100 条最多 $6.00。

请求失败或者没有结果时怎么收费?

按条计费;一次请求条数少或没有结果时,每取一页收费不超过这个接口每页的最低收费,可能更低;我们这边出错或超时不收费。回答里的 meta 写着这次收了多少、余额还剩多少。