用 curl 调用 Google Search API：速查参考 (2026)

测试 Google Search API 最快的方式就是在你的终端中进行。示例使用 serp.cheap。

基本请求

curl https://api.serp.cheap/v1/search \
  -H "X-API-Key: YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"q": "best electric cars 2026", "gl": "us", "page": 1}'

国家与时间过滤

# 来自巴西的结果，最近 24 小时
curl https://api.serp.cheap/v1/search \
  -H "X-API-Key: YOUR_KEY" -H "Content-Type: application/json" \
  -d '{"q": "eleições", "gl": "br", "tbs": "qdr:d"}'

在 Google Search API 参数中查看所有选项。

用 jq 美化输出并提取

# 只取自然搜索链接
curl -s https://api.serp.cheap/v1/search \
  -H "X-API-Key: YOUR_KEY" -H "Content-Type: application/json" \
  -d '{"q": "serp api curl", "gl": "us"}' | jq -r '.organic[].link'

# 标题 + 链接，以 TSV 格式输出
... | jq -r '.organic[] | [.position, .title, .link] | @tsv'

# 这次调用花了多少？
... | jq '.stats'

分页

for p in 1 2 3; do
  curl -s https://api.serp.cheap/v1/search \
    -H "X-API-Key: YOUR_KEY" -H "Content-Type: application/json" \
    -d "{\"q\": \"serp api\", \"page\": $p}" | jq -r '.organic[].link'
done

请把你的密钥保存在环境变量中（-H "X-API-Key: $SERP_KEY"），而不要把它直接粘贴到脚本里。

下一步

Frequently asked questions

如何用 curl 测试 Google Search API？+

在请求头中带上你的密钥，POST 一个 JSON 请求体：curl https://api.serp.cheap/v1/search -H 'X-API-Key: KEY' -H 'Content-Type: application/json' -d '{"q":"...","gl":"us"}'。

如何只提取链接？+

将响应管道传给 jq：... | jq -r '.organic[].link'。