无需 KYC — 无需 ID、无需自拍、无需文件。使用加密货币支付:BTC, USDT, USDC, ETH, SOL, LTC
语言: 简体中文
获取 API 密钥

免费健康检查 · 错误代码 · 事件日志

API 状态:如何检查其是否正常工作

本页没有显示正常运行时间数据的监控组件。下面给出你可以自己用一行命令执行的检查方法,以及如何解读返回结果。

最后更新:

快速回答

如何检查 SerpCrypto API 是否正常工作?

用你的密钥调用 GET https://serpcrypto.com/api/v1/credits:该调用免费,并以 JSON 返回你剩余的积分。返回 200 表示 API 和你的密钥都正常。错误 502 和 504 来自失败的搜索,且绝不会计费。SerpCrypto 会在更新日志 中发布故障事件;在实测之前不会公布任何正常运行时间数据。

免费健康检查(不消耗积分)
curl -s https://serpcrypto.com/api/v1/credits -H "Authorization: Bearer $SERPCRYPTO_API_KEY"

每种返回结果代表什么?

HTTP 状态含义是否计费?如何处理
200API 正常工作;对于搜索请求,结果在响应体中一次成功的搜索计 1 积分;积分查询免费无
401 invalid_api_key密钥缺失、错误或已撤销否从控制台重新复制密钥
402 insufficient_credits账户积分已用完否在价格页面 购买积分包
429 concurrency_limit同时进行的搜索太多否减少并行请求,或申请更高的限额
502 search_failed搜索未能完成否稍等片刻后重试
504 search_timeout未能在规定时间内返回结果否稍等片刻后重试

问题出在我这边、你们这边,还是搜索引擎那边?

先运行免费检查,再做一次简单搜索,最后再发你的真实请求。每一步隔离一层问题。

  1. 积分调用返回 401:问题出在密钥。检查请求头格式:Authorization: Bearer <key>,中间只有一个空格。
  2. 积分调用正常,但每次搜索都返回 502:采集层或搜索引擎对所有人都出现了故障。等几分钟后重试;期间不会产生任何费用。
  3. 简单查询正常,但你的请求返回 400:某个参数超出了允许的取值列表。搜索参考文档 列出了所有取值。
  4. 结果和你在浏览器里看到的不一样:这通常是地区、语言或设备不同导致的。把 gl、hl、location 和 device 设置成与你对比时所用的一致;参见地区与语言。

故障事件和变更在哪里发布?

在更新日志 中。每条记录都有日期、受影响的内容(某个搜索引擎、某个字段、客户端区域或支付)以及具体变更。新增的字段也会出现在那里,这样解析器就能在需要该字段之前完成更新。

我们不单独运营状态网站,本页也不会显示可能过时的绿灯。上面的免费检查会在你询问的那一刻,告诉你该密钥下 API 的真实状态。

为什么这里没有正常运行时间百分比?

因为我们还没有用公开的方法测量过。正常运行时间数据意味着明确的探测方式、明确的时间段和明确的故障定义。等我们具备这些条件后,会在这里连同测量方法和日期一起公布。在那之前,诚实的承诺就是计费规则:1 积分 = 1 次成功的查询请求,可在任意支持的引擎上返回一页结果。失败的请求不计费。

发生故障时我该向客服提供什么?

写信到 [email protected],附上 search_metadata.id 中的请求 ID(如果没有响应,则提供请求时间)、所用搜索引擎、HTTP 状态和错误代码。切勿附上你的 API 密钥。电子邮件回复在 12 小时内,每周 7 天,包括 API 集成方面的帮助。联系页面 列出了其他能加快回复的细节。

起价 US$0.30/千次搜索 · 无需 KYC

获取 API 密钥