SerpBase

接口参考 · 通用搜索

Google 链接还原

免费：把 Google 结果里的 google.com/goto、/url 跳转链接还原成真实网页地址，每次最多 50 条，可直接传链接列表或整个搜索结果。

POSThttps://api.serpbase.dev/google/resolve
0 积分在 Playground 中调用

示例

BASH
curl -X POST 'https://api.serpbase.dev/google/resolve' \
  -H "Content-Type: application/json" \
  -H 'X-API-Key: YOUR_API_KEY' \
  --max-time 60 \
  -d '{"links":["https://www.google.com/url?sa=t&url=https%3A%2F%2Fwww.example.com%2F"]}'

这个接口暂未发布真实返回示例。可以在 Playground 运行上面的请求查看实时结果。

参数

links
string[]
最多 50 条 Google 结果跳转链接（https://www.google.com/goto?...
更多

或 /url?...），其他网址会被拒绝；重复的只还原一次。

response
object
代替 links：直接传入原样的搜索结果，我们会按出现顺序还原其中所有的 Google 跳转链接。
更多

links 和 response 二选一。

country
string
locale.country 的兼容写法。
更多

每次使用其中一种；接口会校验本产品支持的参数与取值。

cursor
string
pagination.cursor 的兼容写法。
更多

每次使用其中一种；接口会校验本产品支持的参数与取值。

device
string
options.device 的兼容写法。
更多

每次使用其中一种；接口会校验本产品支持的参数与取值。

gl
string
locale.country 的兼容写法。
更多

每次使用其中一种；接口会校验本产品支持的参数与取值。

google_domain
string
locale.engine_domain 的兼容写法。
更多

每次使用其中一种；接口会校验本产品支持的参数与取值。

gooogle_domain
string
locale.engine_domain 的兼容写法。
更多

每次使用其中一种；接口会校验本产品支持的参数与取值。

hl
string
locale.language 的兼容写法。
更多

每次使用其中一种；接口会校验本产品支持的参数与取值。

html
boolean
include_html 的兼容写法。
更多

每次使用其中一种；接口会校验本产品支持的参数与取值。

language
string
locale.language 的兼容写法。
更多

每次使用其中一种；接口会校验本产品支持的参数与取值。

limit
integer
pagination.limit 的兼容写法。
更多

每次使用其中一种；接口会校验本产品支持的参数与取值。

markdown
boolean
include_markdown 的兼容写法。
更多

每次使用其中一种；接口会校验本产品支持的参数与取值。

mobile
boolean
options.device 的兼容写法。
更多

每次使用其中一种；接口会校验本产品支持的参数与取值。

num
integer
pagination.limit 的兼容写法。
更多

每次使用其中一种；接口会校验本产品支持的参数与取值。

page
integer
pagination.page 的兼容写法。
更多

每次使用其中一种；接口会校验本产品支持的参数与取值。

q
string
query 的兼容写法。
更多

每次使用其中一种；接口会校验本产品支持的参数与取值。

results
integer
pagination.limit 的兼容写法。
更多

每次使用其中一种；接口会校验本产品支持的参数与取值。

免费（0 积分）。限额：每次最多 50 条链接，每个账户每分钟最多 30 次。Google 对这类链接限速，所以一次请求最多可能需要约 25 秒；来不及还原的会返回 reason 为 paced_over_budget。请约两分钟后再发这些链接：提前重发会让 Google 的等待时间变长。

返回字段

某次请求页面上没有的内容，对应字段会直接省略，而不是返回空值。

resolved_links
必填
ResolvedLink[]

必填

每条链接一项，顺序与请求一致。

ResolvedLink 结果项字段

link
必填
string

必填

传入的原始 Google 链接。

url
可选
string

还原成功时返回。

链接指向的真实网页。本次没能还原时不返回该字段。

reason
必填
string

必填

resolved 表示成功；否则说明原因：paced_over_budget（Google 要求等待的时间超过单次请求上限，请约两分钟后再发，不要提前重发）、challenge、no_location、timeout、not_a_wrapper、error。

失败时

失败的请求 status 不为 0 并带有 error，不扣费。这个接口常见的有：

1000参数缺失或有误修改请求
1020积分不足充值
1029超过每秒请求数等待 Retry-After 秒
1502 · 1504这次没能读取到目标网站重试
全部状态码 →