0%

Google SERP API:用一次请求拿到结构化的搜索结果

很多需求的第一步其实是”搜一下”:做行业调研、监控关键词排名、给 AI Agent 喂实时资料、批量核实信息……但直接爬 Google 又麻烦又不稳定——要处理反爬、验证码、页面结构变化。

Google SERP API 就是把这件事变简单:你传一个关键词,它返回结构化的 JSON——自然结果、知识图谱、相关问题、相关搜索都分好类,直接能用。这篇讲怎么用 Ace Data Cloud 上的这个接口。地址是 POST https://api.acedata.cloud/serp/google,文档在 platform.acedata.cloud/documents/serp-google。到控制台拿一个 Token 就能用,首次带免费额度。

基本用法

最简单的用法就是传 query

1
2
3
4
5
6
7
8
9
10
11
curl -X POST 'https://api.acedata.cloud/serp/google' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
"type": "search",
"query": "nano banana image model",
"country": "US",
"language": "en",
"number": 5
}'

下面是这条请求真实返回的自然结果(节选,cost 也是真实记录的——这次是 0.0092 credit):

1
2
3
4
5
6
7
8
9
10
11
12
{
"organic": [
{"position": 1, "title": "Nano Banana 2 - Gemini AI image generator & photo editor", "link": "https://gemini.google/overview/image-generation/"},
{"position": 2, "title": "Nano Banana | Google AI Studio", "link": "https://aistudio.google.com/models/nano-banana"},
{"position": 3, "title": "Nano Banana: Free Online AI Image Editor", "link": "https://nanobanana.io/"},
{"position": 4, "title": "Gemini Image – Nano Banana - Google DeepMind", "link": "https://deepmind.google/models/gemini-image/"},
{"position": 5, "title": "Nano Banana image generation - Interactions API", "link": "https://ai.google.dev/gemini-api/docs/image-generation"}
],
"people_also_ask": [ ... ],
"related_searches": [ ... ],
"cost": {"amount": 0.0092, "currency": "credit", "list_amount": 0.01}
}

响应是同步返回的,不用轮询。每条结果都带 position(排名)、titlelinksnippet,有些还带 sitelinks

关键字段

请求侧常用的:

  • type:搜索资源类型,默认 search;平台还支持 images、news 等六种类型,换一个 type 就能查图片或新闻;
  • query:关键词(必填);
  • country / language:结果所在国家和语言,默认 US / en——查不同市场的排名时改这两个;
  • range:时间范围(比如只看最近一周的结果);
  • number / page:每页条数和页码。

响应侧除了 organic(自然结果),常见的还有:

  • knowledge_graph:实体卡片(公司/人物的官网、简介、关键属性),查品牌或人物时很有用;
  • people_also_ask:相关问题,做内容选题时是现成的长尾词来源;
  • related_searches:相关搜索词。

能拿它做什么

  • 关键词排名监控:定时查同一批关键词,记录每个域名的 position,做 SEO 排名追踪;
  • 给 AI Agent 补实时信息:大模型的知识有截止时间,把 SERP 结果拼进上下文,就能让它基于”当下真实搜索结果”回答,是搭 RAG / 联网问答的常用一环;
  • 内容选题:用 people_also_askrelated_searches 反查用户真正在问什么,选题不靠猜;
  • 竞品与舆情type 换成 news,定时监控某个关键词的最新报道。

因为返回是干净的 JSON,这些活都不用你去解析 HTML,写几行代码就能跑成定时任务。

顺带说说收益

SERP 这类”基础设施型”接口,最容易做成可转售的服务:一个排名监控面板、一个内容选题助手、一个给别人 Agent 用的联网搜索工具——底层都只是这一个接口,你的成本就是每次查询按量计费那部分(比如上面这次 0.0092 credit)。把工具或注册链接分发出去,通过 Ace Data Cloud 创收联盟让经你注册的用户消费产生返佣,是一条顺带的收入。

参考链接

先用免费额度查一个你关心的关键词,看看返回的结构,再决定怎么把它接进你的工具。