Google organic results with true rank and page blocks
crawl4ai.google.serp.organicOne Google results page as JSON: every organic result with its rank (position, and position_absolute counting the blocks above it), and each block Google showed (People also ask, local pack, videos, ...; the AI Overview when Google showed one: always with source=google, otherwise only when the answer came from Google directly, see note). Localised to a country, a language and optionally a city. When results is empty, empty_reason says why: google_no_results (Google matched nothing) or rescue_no_results (another provider may still have results).
- 价格
- $0.00015/success按供应商原价
- 成功率
- 90.4%近 30 天 · 916,596 次
- 延迟 p50
- 4.9 秒p95 11 秒
- 最后验证
- 2026年10月9日实测可用
GEThttps://toolswitch.dev/v1/tools/crawl4ai.google.serp.organic?q=best+crm+software&country=us预览- 可用平台额度调用
- 同步返回
- 读取公开数据
参数
| 参数 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|
| 查询参数 | ||||
q | 字符串 | 必填 | the query, up to 512 characters | best crm software |
num | 整数 | 可选 | results to return: a multiple of 10 from 10 to 100 (num/10 Google pages); default 10 | |
page | 整数 | 可选 | page over num, 1 to 30: num=10&page=2 is results 11-20 | |
time | 字符串 | 可选 | Google's time filter | |
fresh | 字符串 | 可选 | 1 skips the cache | |
source | 字符串 | 可选 | auto (default) may answer from Crawl4AI's fallback page, which has no AI Overview; google answers from Google's own page only, with the AI Overview when Google shows one, and is a free 503 when Google cannot be reached | |
country | 字符串 | 可选 | two-letter Google country (gl), default us | us |
language | 字符串 | 可选 | Google interface language (hl), e.g. en or pt-br; default en | |
location | 字符串 | 可选 | a city or region, e.g. Austin, TX; an unknown place answers 400 with the closest names | |
- 查询参数
q字符串必填the query, up to 512 characters
示例：
best crm softwarenum整数可选results to return: a multiple of 10 from 10 to 100 (num/10 Google pages); default 10
page整数可选page over num, 1 to 30: num=10&page=2 is results 11-20
time字符串可选Google's time filter
fresh字符串可选1 skips the cache
source字符串可选auto (default) may answer from Crawl4AI's fallback page, which has no AI Overview; google answers from Google's own page only, with the AI Overview when Google shows one, and is a free 503 when Google cannot be reached
country字符串可选two-letter Google country (gl), default us
示例：
uslanguage字符串可选Google interface language (hl), e.g. en or pt-br; default en
location字符串可选a city or region, e.g. Austin, TX; an unknown place answers 400 with the closest names
代码示例
将 $TOOLSWITCH_KEY 替换为你在控制台创建的密钥。
curl -X GET 'https://toolswitch.dev/v1/tools/crawl4ai.google.serp.organic?q=best+crm+software&country=us' \
-H "X-Toolswitch-Key: $TOOLSWITCH_KEY"import os
import requests
response = requests.request(
"GET",
"https://toolswitch.dev/v1/tools/crawl4ai.google.serp.organic?q=best+crm+software&country=us",
headers={"X-Toolswitch-Key": os.environ["TOOLSWITCH_KEY"]},
)
response.raise_for_status()
print(response.text)const response = await fetch("https://toolswitch.dev/v1/tools/crawl4ai.google.serp.organic?q=best+crm+software&country=us", {
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.00015/success 计费，已含服务费。