快速开始
- 用谷歌账号或邮箱验证码登录。新账号第一次登录(用谷歌账号或邮箱验证码)就送 $0.30 试用额度,每个邮箱一份,每条价格不超过 $0.005 的接口可以用。
- 在控制台的 API keys 页建一把 key,复制下来(只显示一次)。
- 发第一个请求:
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。
{
"data": [
{
"…": "…"
}
],
"cursor": null,
"meta": {
"request_id": "req_01…",
"charged_usd": "0.018650",
"balance_usd": "9.981350",
"items": 5
}
}| meta | 意思 |
|---|---|
| request_id | 这次请求的编号,也在 X-Request-Id 头里。报问题时带上它。 |
| items | data 里的条数。 |
| 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" }}
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。
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- 这次请求花了多少、还剩多少,每次都返回。
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" }
}
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" }
}
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 可能计费(见下)。
{
"error": {
"code": "invalid_key",
"message": "The API key is missing or not valid."
},
"meta": {
"request_id": "req_01…"
}
}| code | HTTP | 意思 |
|---|---|---|
| bad_request | 400 | 参数不合法(比如 limit 不在 1 到 100 之间,或者请求体不是 JSON 对象)。 |
| bad_input | 400 | 平台不接受这个输入,message 里写了原因。 |
| cursor_invalid | 400 | cursor 不是这个接口发出的。去掉 cursor 从头取。 |
| cursor_mismatch | 400 | cursor 属于参数不同的另一个请求。翻页之间只有 limit 可以变。 |
| cursor_expired | 400 | cursor 超过一小时,或者列表已经没法从这里接着取。去掉 cursor 从头取。 |
| cursor_paused_today | 429 | 这个 cursor 要到 UTC 零点以后才能接着用(resumes_at);在那之前列表只能取第一页。不收费。 |
| invalid_key | 401 | API key 没带、格式不对或已作废。 |
| insufficient_balance | 402 | 余额不够这次请求预扣的金额,返回里写了两个数。 |
| account_frozen | 403 | 这个账户已按服务条款暂停。请用账户的邮箱写信到 hello@silklinedata.com。 |
| unknown_endpoint | 404 | 没有这个接口,或者它没有在卖。 |
| not_found | 404 | 平台回答说你要的东西不存在。这个 404 可能计费,最多按接口的最低收费,见 meta.charged_usd。返回里同时有 data(空)和 cursor(null)。 |
| payload_too_large | 413 | 请求体超过 16 KB。 |
| rate_limited | 429 | 一分钟内请求太多,慢一点再试。 |
| daily_cap | 429 | 达到 key 或账号当天的花费上限,返回里写了上限。 |
| source_unavailable | 502 | 平台没有回应。不收费,稍后再试。 |
| mode_unavailable | 503 | 这个接口暂停了。不收费。 |
| account_paused_today | 429 | 这个账号今天的请求已暂停到 UTC 零点;resumes_at 和 Retry-After 写了几点恢复。不收费。如果你的使用是正常的,请写信给我们。 |
| service_paused_today | 503 | 服务今天对部分请求暂停到 UTC 零点;resumes_at 和 Retry-After 写了几点恢复。不收费。 |
| busy | 503 | 服务繁忙。不收费,稍后重试。 |
| source_timeout | 504 | 平台回得太慢。不收费。 |
限速
- 每个 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)。
一张逐行看得懂的账单。
按今天的价格算的五个示例请求。每一行都是每条单价乘上实际拿到的条数。
POST /v1/weibo/search | 20 条 | 20 × $0.00373 | $0.0746 |
POST /v1/xiaohongshu/search | 20 条 | 20 × $0.0018 | $0.036 |
POST /v1/douyin-comments/comments | 502 · 没有回应 | 不扣钱 | $0 |
POST /v1/xiaohongshu/search | 0 条 · 最多按最低收费 | 平台有回应但没有结果:最多按这个接口的最低收费 | $0.025 |
POST /v1/xiaohongshu/search {…, "cursor": …} | 20 条 · 第 2 页 | 同一个请求,带回 cursor · 20 × $0.0018 | $0.036 |
| 共扣 | $0.1716 | ||
|---|---|---|---|
| 剩余余额 | $9.8284 | ||