文档, 从 key 到拿到数据。

一个请求要知道的都在这一页:key、请求、返回、翻页、错误、限速和花费。

本页目录8
  1. 快速开始
  2. 鉴权
  3. 发请求
  4. 返回和 meta
  5. 翻页
  6. 错误码
  7. 限速
  8. 计费规则

快速开始

  1. 用谷歌账号或邮箱验证码登录。新账号第一次登录(用谷歌账号或邮箱验证码)就送 $0.30 试用额度,每个邮箱一份,每条价格不超过 $0.005 的接口可以用。
  2. 在控制台的 API keys 页建一把 key,复制下来(只显示一次)。
  3. 发第一个请求:
curl
curl -X POST "https://api.silklinedata.com/v1/weibo/hot" \
  -H "Authorization: Bearer $SILKLINE_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit": 5}'

换别的接口只改路径里的 /v1/{tool}/{mode} 和参数。每个接口要哪些参数、返回什么,见平台里各接口的页面。

整个目录也有一份 JSON:GET /api/public-catalog?lang=zh 列出每个在卖接口的名字、说明、参数(名字、类型、是否必填)、示例输入、能不能翻页和价格,不用 key。GET /v1/endpoints 只有价格。

鉴权

每个请求带 Authorization: Bearer slk_… 头。key 不对、没带或已作废返回 401 invalid_key。key 只在服务端用,别放进网页或 App 里;漏了就在控制台作废它再建一把。

发请求

POST /v1/{tool}/{mode},参数放在 JSON 请求体里(最大 16 KB),列表参数也能直接传。本站所有示例都用这种写法。

也接受 GET,参数放在查询串里,但只适合每个参数都是一个词或一个数的接口:查询串里的值都是文字,列表和 true/false 要用 POST。

limit:这次最多返回几条,1 到 100,默认 20。返回的条数永远不会超过它。cursor:翻页用,见下文。

返回和 meta

成功时返回 HTTP 200 和 {data, cursor, meta}:data 是记录的数组(什么都没找到时是空数组),cursor 是下一页的书签或 null。

200 OK
{
  "data": [
    {
      "…": "…"
    }
  ],
  "cursor": null,
  "meta": {
    "request_id": "req_01…",
    "charged_usd": "0.018650",
    "balance_usd": "9.981350",
    "items": 5
  }
}
meta意思
request_id这次请求的编号,也在 X-Request-Id 头里。报问题时带上它。
itemsdata 里的条数。
charged_usd这次扣的钱(美元,6 位小数)。
balance_usd扣完以后还能花的余额。
minimum_usd按条算不到最低收费时,补的那部分。
same_price_up_to收了最低收费时,同样的钱最多能拿多少条:把 limit 调到这个数,钱不变。
partial、reason这次只拿到一部分时出现,reason 写原因。

换一个平台名,其余代码一行不改。

33 个平台接同一种请求、回同一个结构:记录在 data,下一页在 cursor,花费在 meta。

小红书 · 搜索笔记
POST /v1/xiaohongshu/search
Authorization: Bearer $SILKLINE_KEY

{"keyword":"星巴克","limit":20}
{  "data": [    {      "type": "note",      "publishedAt": "2026-10-05T20:02:38Z",      "title": "星巴克🎄2026 Holiday Menu",      "likes": 237,      "collects": 63,      "noteId": "6ac4025e0000000012035ea2",      "url": "https://www.xiaohongshu.com/explo…"    }  ],  "cursor": "c1.v7Kq2LmX9pTe.Zr4w…",  "meta": { "charged_usd": "0.036000" }}
B 站 · 搜索视频
POST /v1/bilibili/search
Authorization: Bearer $SILKLINE_KEY

{"keyword":"大疆","limit":20}
{  "data": [    {      "type": "video",      "publishedAt": "2026-11-11T01:00:00Z",      "title": "大疆 Osmo Action 7 ,GoPro 杀…",      "views": 3834,      "likes": 11,      "bvid": "BV17jWN6gEro",      "url": "https://www.bilibili.com/video/BV…"    }  ],  "cursor": "c1.N3fYc8RbQ1sH.k0Tq…",  "meta": { "charged_usd": "0.147200" }}

翻页

返回里 cursor 不是 null 时还有下一页:把它原样放进下一个请求,其余参数不变(limit 可以改)。最后一页的 cursor 是 null。cursor 一小时内有效。每一页是一次独立的请求,单独计费。接口页上写了它能不能翻页;不能翻页的接口一次请求就返回全部,cursor 一直是 null。

Python
import os, requests

url = "https://api.silklinedata.com/v1/xiaohongshu/search"
params = {"keyword": "coffee", "limit": 100}
headers = {"Authorization": "Bearer " + os.environ["SILKLINE_KEY"]}
records, cursor = [], None
while True:
    body = dict(params, cursor=cursor) if cursor else params
    answer = requests.post(url, headers=headers, json=body).json()
    records += answer["data"]
    cursor = answer["cursor"]
    if not cursor:
        break

任何列表都能一页页取

带着 cursor 再发同一个请求,就是下一批;列表到头时 cursor 是 null。

data
记录本身,字段和文档里写的一样。不会超过你要的 limit。
cursor
列表还有更多时才有。带着它再发同一个请求,就是下一批。
meta
这次请求花了多少、还剩多少,每次都返回。
第 1 页,共 3 页 · 本页 20 条;这里显示 1 条
POST /v1/xiaohongshu/search
Authorization: Bearer $SILKLINE_KEY

{"keyword":"星巴克","limit":20}
{
  "data": [
    { "noteId": "6ac4025e0000000012035ea2", "title": "星巴克🎄2026 Holiday Menu",
      "likes": 237, "comments": 12 }
  ],
  "cursor": "c1.Gt5nR1zVb8Ky.Qe2s…",
  "meta": { "charged_usd": "0.036000", "balance_usd": "9.964000" }
}
第 2 页,共 3 页 · 本页 20 条;这里显示 1 条
POST /v1/xiaohongshu/search
Authorization: Bearer $SILKLINE_KEY

{"keyword":"星巴克","limit":20,"cursor":"c1.Gt5nR1zVb8Ky.Qe2s…"}
{
  "data": [
    { "noteId": "6af563aa00000000160196e7", "title": "新🎄星:圣诞抹茶苹果奶",
      "likes": 1254, "comments": 47 }
  ],
  "cursor": "c1.a9MhT4wLc3Px.Uv6d…",
  "meta": { "charged_usd": "0.036000", "balance_usd": "9.928000" }
}
第 3 页,共 3 页 · 本页 5 条,按最低收费;这里显示 1 条
POST /v1/xiaohongshu/search
Authorization: Bearer $SILKLINE_KEY

{"keyword":"星巴克","limit":20,"cursor":"c1.a9MhT4wLc3Px.Uv6d…"}
{
  "data": [
    { "noteId": "6af7aca0000000002a019b4f", "title": "终于在北美星巴克喝上太妃榛…",
      "likes": 105, "comments": 11 }
  ],
  "cursor": null,
  "meta": { "charged_usd": "0.025000", "balance_usd": "9.903000" }
}

错误码

出错时返回对应的 HTTP 状态码和 {error: {code, message}, meta: {request_id}}。我们这边的错误不收费;not_found 可能计费(见下)。

401
{
  "error": {
    "code": "invalid_key",
    "message": "The API key is missing or not valid."
  },
  "meta": {
    "request_id": "req_01…"
  }
}
codeHTTP意思
bad_request400参数不合法(比如 limit 不在 1 到 100 之间,或者请求体不是 JSON 对象)。
bad_input400平台不接受这个输入,message 里写了原因。
cursor_invalid400cursor 不是这个接口发出的。去掉 cursor 从头取。
cursor_mismatch400cursor 属于参数不同的另一个请求。翻页之间只有 limit 可以变。
cursor_expired400cursor 超过一小时,或者列表已经没法从这里接着取。去掉 cursor 从头取。
cursor_paused_today429这个 cursor 要到 UTC 零点以后才能接着用(resumes_at);在那之前列表只能取第一页。不收费。
invalid_key401API key 没带、格式不对或已作废。
insufficient_balance402余额不够这次请求预扣的金额,返回里写了两个数。
account_frozen403这个账户已按服务条款暂停。请用账户的邮箱写信到 hello@silklinedata.com。
unknown_endpoint404没有这个接口,或者它没有在卖。
not_found404平台回答说你要的东西不存在。这个 404 可能计费,最多按接口的最低收费,见 meta.charged_usd。返回里同时有 data(空)和 cursor(null)。
payload_too_large413请求体超过 16 KB。
rate_limited429一分钟内请求太多,慢一点再试。
daily_cap429达到 key 或账号当天的花费上限,返回里写了上限。
source_unavailable502平台没有回应。不收费,稍后再试。
mode_unavailable503这个接口暂停了。不收费。
account_paused_today429这个账号今天的请求已暂停到 UTC 零点;resumes_at 和 Retry-After 写了几点恢复。不收费。如果你的使用是正常的,请写信给我们。
service_paused_today503服务今天对部分请求暂停到 UTC 零点;resumes_at 和 Retry-After 写了几点恢复。不收费。
busy503服务繁忙。不收费,稍后重试。
source_timeout504平台回得太慢。不收费。

限速

  • 每个 IP 每分钟约 600 次,每把 key 每分钟约 300 次,超了返回 429 rate_limited。这两个数是近似值:实际放行的次数可能比它多或少一些,不要按它卡着发;收到 429 就等一会儿再试。
  • 每天的花费有上限:目前,首次充值后每天 $20;累计充值满 $50 且首次充值满 7 天后每天 $200。每把 key 还可以在控制台设自己的每日上限。到上限返回 429 daily_cap。
  • 一次请求最长约 26 秒,超时返回 504,不收费。

计费规则

  • 按返回的条数收费,每个接口有自己的每条价格,见价格。
  • 充值时另收手续费,充值页在付款前写明;每条的单价里不含手续费,手续费不退。
  • 按条计费;一次请求条数少或没有结果时,每取一页收费不超过这个接口每页的最低收费,可能更低;我们这边出错或超时不收费。收了最低收费时,返回里的 same_price_up_to 告诉你同样的钱能拿多少条。每个接口页写着它的最低收费和一页多少条。
  • 账户开通期间余额不过期,不订阅,不自动续费。
  • 每个返回都写着这次扣了多少(charged_usd)和还剩多少(balance_usd)。

一张逐行看得懂的账单。

按今天的价格算的五个示例请求。每一行都是每条单价乘上实际拿到的条数。

示例:五个请求 · 原有余额 $10.00
POST /v1/weibo/search20 条20 × $0.00373$0.0746
POST /v1/xiaohongshu/search20 条20 × $0.0018$0.036
POST /v1/douyin-comments/comments502 · 没有回应不扣钱$0
POST /v1/xiaohongshu/search0 条 · 最多按最低收费平台有回应但没有结果:最多按这个接口的最低收费$0.025
POST /v1/xiaohongshu/search {…, "cursor": …}20 条 · 第 2 页同一个请求,带回 cursor · 20 × $0.0018$0.036
共扣$0.1716
剩余余额$9.8284