SerpApiGoogleSEO/AEO

Google organic search results for a query

serpapi.google.serp.organic

Live Google organic results for a keyword — position, title, URL, snippet, by location

价格: $0.015/success按供应商原价
成功率: 92.2%近 30 天 · 14,168 次
延迟 p50: 1.7 秒p95 58 秒
最后验证: 2026年7月28日实测可用

GEThttps://toolswitch.dev/v1/tools/serpapi.google.serp.organic?q=coffee&engine=google预览

可用平台额度调用
同步返回
读取公开数据

参数

Answers arrive in `organic_results`; the same response may also carry `knowledge_graph`, `local_results`, `related_questions`, `related_searches` and `pagination`. `num` IS NOT DOCUMENTED for this engine — Google dropped it upstream and SerpApi's google parameter list does not include it. Page with `start`, not `num`; sending `num` is not a supported way to widen a page.

参数	类型	必填	说明	示例
查询参数
`q`	字符串	必填	the search query; Google search operators work here	`coffee`
`cr`	字符串	可选	restrict to countries, e.g. countryUS; multiple joined by \|
`gl`	字符串	可选	country code for the search, e.g. us, uk	`us`
`hl`	字符串	可选	interface language code, e.g. en	`en`
`lr`	字符串	可选	restrict to languages, e.g. lang_en; multiple joined by \|
`lat`	数字	可选	latitude; requires lon and a matching gl
`lon`	数字	可选	longitude; requires lat
`tbm`	字符串	可选	switches the Google vertical: isch (images), vid, nws, shop, lcl, pts
`tbs`	字符串	可选	advanced Google filters, e.g. date range
`nfpr`	字符串	可选	1 disables Google's auto-correction to a different spelling
`safe`	字符串	可选	active \| off
`uule`	字符串	可选	Google's encoded location, as an alternative to `location`
`start`	整数	可选	result offset for pagination — 0, 10, 20 … This is how you page; see the note about `num`	`0`
`device`	字符串	可选	desktop (default) \| tablet \| mobile
`engine`	字符串	必填	the engine selector — must be this literal string	`google`
`filter`	字符串	可选	0 turns off Google's similar-results and omitted-results filters
`radius`	整数	可选	metres around lat/lon; 1-199 on desktop, 1-1000 on mobile
`location`	字符串	可选	city-level origin of the search, e.g. "Austin, Texas, United States". Mutually exclusive with uule and with lat/lon
`google_domain`	字符串	可选	default google.com; e.g. google.co.uk

查询参数
q字符串必填
the search query; Google search operators work here
示例：coffee
cr字符串可选
restrict to countries, e.g. countryUS; multiple joined by |
gl字符串可选
country code for the search, e.g. us, uk
示例：us
hl字符串可选
interface language code, e.g. en
示例：en
lr字符串可选
restrict to languages, e.g. lang_en; multiple joined by |
lat数字可选
latitude; requires lon and a matching gl
lon数字可选
longitude; requires lat
tbm字符串可选
switches the Google vertical: isch (images), vid, nws, shop, lcl, pts
tbs字符串可选
advanced Google filters, e.g. date range
nfpr字符串可选
1 disables Google's auto-correction to a different spelling
safe字符串可选
active | off
uule字符串可选
Google's encoded location, as an alternative to `location`
start整数可选
result offset for pagination — 0, 10, 20 … This is how you page; see the note about `num`
示例：0
device字符串可选
desktop (default) | tablet | mobile
engine字符串必填
the engine selector — must be this literal string
示例：google
filter字符串可选
0 turns off Google's similar-results and omitted-results filters
radius整数可选
metres around lat/lon; 1-199 on desktop, 1-1000 on mobile
location字符串可选
city-level origin of the search, e.g. "Austin, Texas, United States". Mutually exclusive with uule and with lat/lon
google_domain字符串可选
default google.com; e.g. google.co.uk

代码示例

将 $TOOLSWITCH_KEY 替换为你在控制台创建的密钥。

预览

curl -X GET 'https://toolswitch.dev/v1/tools/serpapi.google.serp.organic?q=coffee&engine=google' \
  -H "X-Toolswitch-Key: $TOOLSWITCH_KEY"

import os
import requests

response = requests.request(
    "GET",
    "https://toolswitch.dev/v1/tools/serpapi.google.serp.organic?q=coffee&engine=google",
    headers={"X-Toolswitch-Key": os.environ["TOOLSWITCH_KEY"]},
)
response.raise_for_status()
print(response.text)

const response = await fetch("https://toolswitch.dev/v1/tools/serpapi.google.serp.organic?q=coffee&engine=google", {
  method: "GET",
  headers: {
    "X-Toolswitch-Key": process.env.TOOLSWITCH_KEY ?? "",
  },
});
if (!response.ok) throw new Error(`Request failed: ${response.status}`);
console.log(await response.text());

网关接口为预览版，地址与鉴权方式可能调整。示例参数仅为样例数据。调用按 $0.015/success 计费，已含服务费。