排名跟踪
按城市和设备,每天跟踪数千个关键词的排名。
Google SERP API
发送一个关键词,即可获取任意国家、城市和设备下的已解析结果页。无需管理代理,无需维护解析器,也无需处理验证码。
curl -G "https://serp.proxonym.com/v1/search" \
-H "X-API-Key: $PROXONYM_SERP_KEY" \
--data-urlencode "q=running shoes" \
-d gl=us -d hl=en \
--data-urlencode "location=Chicago,Illinois" \
-d device=desktop -d page=1{
"search_parameters": { "q": "running shoes", "gl": "us", "hl": "en",
"location": "Chicago,Illinois", "device": "desktop", "page": 1 },
"organic_results": [
{
"position": 1,
"title": "Running Shoes for Men and Women | Stride Supply",
"link": "https://www.stridesupply.example/running-shoes",
"snippet": "Shop road and trail running shoes in every size."
}
],
"ads": [ { "position": 1, "title": "Running Shoes Sale", "link": "…", "snippet": "…" } ],
"people_also_ask": [ { "question": "How often should you replace running shoes?" } ],
"related_searches": [ { "query": "trail running shoes" } ],
"local_results": [ { "position": 1, "title": "Lakeshore Run Co.", "address": "…" } ]
}响应
Google 结果页的每个板块都以带类型的 JSON 数组返回,可直接存入数据库或输入模型。
organic_results每条自然搜索结果的排名、标题、链接和摘要。
ads付费结果及其位置,便于跟踪谁在竞价某个关键词。
people_also_askGoogle 推荐的相关问题,是内容创作和 FAQ 选题的宝库。
related_searches页面底部的相关搜索,可用于关键词拓展。
local_results基于位置的搜索所展示的本地商家列表(Local Pack)。
search_parameters您请求时指定的确切查询词、国家、语言、位置和设备。
本地化
排名在不同城市之间、桌面端与移动端之间都会变化。六个参数即可覆盖所有组合。
| 参数 | 示例 | 作用 |
|---|---|---|
q | running shoes | 搜索查询词(必填) |
gl | us | 搜索所在国家,ISO 代码 |
hl | en | 界面语言 |
location | Chicago,Illinois | 发起搜索的城市或地区 |
device | mobile | desktop 或 mobile 结果 |
page | 2 | 要获取的结果页 |
import os
import requests
resp = requests.get(
"https://serp.proxonym.com/v1/search",
headers={"X-API-Key": os.environ["PROXONYM_SERP_KEY"]},
params={"q": "running shoes", "gl": "us", "hl": "en",
"location": "Chicago,Illinois", "device": "mobile"},
timeout=60,
)
resp.raise_for_status()
for r in resp.json()["organic_results"]:
print(r["position"], r["title"], r["link"])const params = new URLSearchParams({
q: "running shoes", gl: "us", hl: "en",
location: "Chicago,Illinois", device: "mobile",
});
const res = await fetch(`https://serp.proxonym.com/v1/search?${params}`, {
headers: { "X-API-Key": process.env.PROXONYM_SERP_KEY },
});
const data = await res.json();
data.organic_results.forEach(r => console.log(r.position, r.title));套餐
所有套餐均支持全部参数和全部结果类型。用量越大,单次请求价格越低。
价格以美元计,从余额中扣款。套餐从不自动续费。每月请求超过 1000万次?可同时持有多个套餐,或查看大用量方案。
使用场景
同一个 API 调用即可为排名跟踪工具、广告监测工具、调研仪表板和 AI 智能体提供数据。
按城市和设备,每天跟踪数千个关键词的排名。
了解哪些竞争对手在竞价您的关键词,以及他们的广告文案。
让回答基于最新的搜索结果,而非过时的训练数据。
衡量任意市场的需求、本地竞争者和内容空白。
自建还是购买
两者都能获取本地化的 Google 搜索结果。API 以按请求付费换来零维护;自建爬虫则以工程时间换来对采集内容的完全掌控。
| 特性 | SERP API | 自建爬虫 + 代理 |
|---|---|---|
| 代理与轮换 | 已包含 | 自行轮换的住宅代理 |
| 封禁与验证码 | 全部代为处理 | 自行实现重试与退避逻辑 |
| 解析 | 带类型的 JSON | 自行维护的 HTML 解析器 |
| 本地化 | gl, hl, location, device | 在用户名中加入 -country 和 -city |
| 价格 | 每 1,000 次请求低至 $0.16 | 流量低至 $0.74/GB |
| 适用场景 | 大规模排名跟踪 | 自定义页面和其他搜索引擎 |
每个请求以 JSON 格式返回一个 Google 结果页:包含自然搜索结果及其排名、标题、链接和摘要;在 Google 展示相应内容时,还包含广告、“相关问题”(People Also Ask)、相关搜索和本地结果;此外还会返回您所用的搜索参数。
一次 API 调用返回一个结果页,计为一次请求。因此,获取某个关键词的前三页结果需要消耗三次请求。您的套餐会显示本月剩余的请求次数。
可以。用 gl 设置国家,用 hl 设置界面语言,用 location 设置城市或地区(如“Chicago,Illinois”)。使用 device=mobile 可获取移动端结果布局,它往往与桌面端不同。
不需要。SERP API 会替您处理代理、重试和解析,您只需要一个 API 密钥。如果您更想自建爬虫,住宅代理可在网络层面提供同样的地理定位能力。
按“关键词数 × 地点数 × 页数 × 每月查询次数”估算。在 3 个城市每天跟踪 1,000 个关键词一次,每月约需 90,000 次请求,Starter 套餐即可满足。您可以随时升级到更大的套餐。
可以。套餐从余额中扣款,余额可用比特币、以太坊、门罗币、USDT(TRC-20)或 Solana 充值,$30 起充,最高可获 +50% 充值奖励。套餐从不自动续费。了解加密货币支付流程。
SERP API 支持 Google 搜索。如需采集其他搜索引擎的结果,可通过住宅代理运行自建爬虫,获取覆盖 195+ 个国家和地区、支持城市级定位的本地 IP。
发送 GET 请求,在 X-API-Key 请求头中携带您的 API 密钥,并附上搜索参数,例如 q、gl、hl 和 location。本页代码和 API 参考中提供了 Python 和 Node.js 的完整示例。
搜索结果是公开信息,出于 SEO、研究和监测目的采集这些数据是常见做法。您仍需对数据的使用方式负责,并遵守适用的法律法规。我们的可接受使用政策列出了禁止的行为。