LitescrapeGoogleSEO/AEO

Get Google AI Overview

litescrape.google.serp.ai_overview

Returns only the AI Overview from a Google results page, and accepts the Google Search parameters except fast_mode

价格: $0.00015/success按供应商原价
成功率: 55.4%近 30 天 · 13,926 次
延迟 p50: 7.5 秒p95 49 秒
最后验证: 2026年9月29日实测可用

GEThttps://toolswitch.dev/v1/tools/litescrape.google.serp.ai_overview?q=what+is+photosynthesis&gl=us&hl=en预览

在线试用即将上线供应商文档 ↗

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

参数

A 200 with ai_overview:null and search_metadata.ai_overview_state=not_served is unbilled by Litescrape.

参数	类型	必填	说明	示例
查询参数
`q`	字符串	可选	Search query, up to 2,048 characters. Required unless ludocid or kgmid is supplied.	`coffee shops in Austin`
`cr`	字符串	可选	Country restriction: one or more countryXX values joined with \|, such as countryUS.	`countryUS`
`gl`	字符串	可选	Lowercase two-letter country code used to localize results.	`us`
`hl`	字符串	可选	Google interface and result language, such as en, en-US, or de. Defaults to en.	`en`
`lr`	字符串	可选	Language restriction: one or more lang_xx values joined with \|, such as lang_en.	`lang_en`
`oq`	字符串	可选	Original query text from a Google URL, up to 2,048 characters; forwarded unchanged.
`si`	字符串	可选	Opaque cached Google search context, up to 4,096 characters.
`ibp`	字符串	可选	Google layout or expansion control, up to 4,096 characters.
`lat`	数字	可选	Latitude between -90 and 90. Supply with lon; conflicts with location and uule.	`30.2672`
`lon`	数字	可选	Longitude between -180 and 180. Supply with lat; conflicts with location and uule.	`-97.7431`
`num`	整数	可选	Requested result count, 1 to 10. A best-effort hint: Google may return fewer rows, and results are never padded.
`pws`	字符串	可选	Google personalization flag: 0 or 1. 0 asks for non-personalized results.
`tbm`	字符串	可选	Google vertical: lcl, vid, nws, shop, or pts. Google Images (isch) is rejected with 400 unsupported_search_vertical.
`tbs`	字符串	可选	Google search-filter string, such as qdr:w, up to 4,096 characters.
`uds`	字符串	可选	Opaque Google filter token, up to 4,096 characters.
`as_q`	字符串	可选	Additional terms that must all match, up to 2,048 characters.
`lsig`	字符串	可选	Opaque Google local or Knowledge Graph signature, up to 4,096 characters.
`nfpr`	字符串	可选	Set 1 to disable Google spelling auto-correction, or 0 to allow it.
`safe`	字符串	可选	Google adult-content filtering: active or off.
`uule`	字符串	可选	Pre-encoded Google location token, up to 2,048 characters. Use only one of location, uule, or lat and lon.
`as_dt`	字符串	可选	Include (i) or exclude (e) the as_sitesearch host. Requires as_sitesearch.
`as_eq`	字符串	可选	Words the results must not contain, up to 2,048 characters.
`as_lq`	字符串	可选	Return pages that link to this complete HTTP(S) URL.
`as_oq`	字符串	可选	Additional terms of which any may match, up to 2,048 characters.
`as_rq`	字符串	可选	Return pages related to this complete HTTP(S) URL.
`gs_lp`	字符串	可选	Opaque Google autocomplete-session value from a Google URL, up to 4,096 characters; forwarded unchanged.
`kgmid`	字符串	可选	Google Knowledge Graph machine ID, such as /m/0k8z. Can replace q.	`/m/0k8z`
`start`	整数	可选	Result offset for pagination. Defaults to 0.	`10`
`as_epq`	字符串	可选	Exact phrase the results must contain, up to 2,048 characters.
`as_nhi`	整数	可选	Upper bound of a number range. Supply with as_nlo.
`as_nlo`	整数	可选	Lower bound of a number range. Supply with as_nhi.
`as_qdr`	字符串	可选	Date range: d, w, m, or y with an optional positive count, such as m3 for the past three months.	`m3`
`device`	字符串	可选	Google returns its real layout for the selected device: desktop, tablet, or mobile.	`desktop`
`filter`	字符串	可选	Google similar-results filtering: 0 or 1.
`radius`	数字	可选	Search radius in meters around location or lat and lon, which it requires. 1 to 199 on desktop, 1 to 1,000 on tablet or mobile.
`ludocid`	字符串	可选	Decimal Google CID for a local entity search. Can replace q.	`1234567890123456789`
`sclient`	字符串	可选	Google client label such as gws-wiz-serp: up to 64 letters, digits, dots, underscores, or hyphens.
`timeout`	数字	可选	Optional budget for the entire request in seconds, measured from gateway receipt until the response is ready to send. Includes admission, queueing and settlement. Must be greater than 0 and at most 90. On expiry, the call is not billed and returns 503 request_deadline_exceeded with retryable=true and a request ID. Omit to retain the standard server deadline.
`location`	字符串	可选	Human-readable search location, up to 512 characters. Use only one of location, uule, or lat and lon.	`Austin, Texas, United States`
`peek_pws`	字符串	可选	Google personalization companion flag: 0 or 1, forwarded to Google unchanged.
`color_scheme`	字符串	可选	Google's light or dark result presentation.
`as_sitesearch`	字符串	可选	Hostname to include or exclude, such as example.com. A hostname, not a URL.	`example.com`
`google_domain`	字符串	可选	A Google domain from Google's supported list, such as google.com or google.co.uk.	`google.com`

查询参数
q字符串可选
Search query, up to 2,048 characters. Required unless ludocid or kgmid is supplied.
示例：coffee shops in Austin
cr字符串可选
Country restriction: one or more countryXX values joined with |, such as countryUS.
示例：countryUS
gl字符串可选
Lowercase two-letter country code used to localize results.
示例：us
hl字符串可选
Google interface and result language, such as en, en-US, or de. Defaults to en.
示例：en
lr字符串可选
Language restriction: one or more lang_xx values joined with |, such as lang_en.
示例：lang_en
oq字符串可选
Original query text from a Google URL, up to 2,048 characters; forwarded unchanged.
si字符串可选
Opaque cached Google search context, up to 4,096 characters.
ibp字符串可选
Google layout or expansion control, up to 4,096 characters.
lat数字可选
Latitude between -90 and 90. Supply with lon; conflicts with location and uule.
示例：30.2672
lon数字可选
Longitude between -180 and 180. Supply with lat; conflicts with location and uule.
示例：-97.7431
num整数可选
Requested result count, 1 to 10. A best-effort hint: Google may return fewer rows, and results are never padded.
pws字符串可选
Google personalization flag: 0 or 1. 0 asks for non-personalized results.
tbm字符串可选
Google vertical: lcl, vid, nws, shop, or pts. Google Images (isch) is rejected with 400 unsupported_search_vertical.
tbs字符串可选
Google search-filter string, such as qdr:w, up to 4,096 characters.
uds字符串可选
Opaque Google filter token, up to 4,096 characters.
as_q字符串可选
Additional terms that must all match, up to 2,048 characters.
lsig字符串可选
Opaque Google local or Knowledge Graph signature, up to 4,096 characters.
nfpr字符串可选
Set 1 to disable Google spelling auto-correction, or 0 to allow it.
safe字符串可选
Google adult-content filtering: active or off.
uule字符串可选
Pre-encoded Google location token, up to 2,048 characters. Use only one of location, uule, or lat and lon.
as_dt字符串可选
Include (i) or exclude (e) the as_sitesearch host. Requires as_sitesearch.
as_eq字符串可选
Words the results must not contain, up to 2,048 characters.
as_lq字符串可选
Return pages that link to this complete HTTP(S) URL.
as_oq字符串可选
Additional terms of which any may match, up to 2,048 characters.
as_rq字符串可选
Return pages related to this complete HTTP(S) URL.
gs_lp字符串可选
Opaque Google autocomplete-session value from a Google URL, up to 4,096 characters; forwarded unchanged.
kgmid字符串可选
Google Knowledge Graph machine ID, such as /m/0k8z. Can replace q.
示例：/m/0k8z
start整数可选
Result offset for pagination. Defaults to 0.
示例：10
as_epq字符串可选
Exact phrase the results must contain, up to 2,048 characters.
as_nhi整数可选
Upper bound of a number range. Supply with as_nlo.
as_nlo整数可选
Lower bound of a number range. Supply with as_nhi.
as_qdr字符串可选
Date range: d, w, m, or y with an optional positive count, such as m3 for the past three months.
示例：m3
device字符串可选
Google returns its real layout for the selected device: desktop, tablet, or mobile.
示例：desktop
filter字符串可选
Google similar-results filtering: 0 or 1.
radius数字可选
Search radius in meters around location or lat and lon, which it requires. 1 to 199 on desktop, 1 to 1,000 on tablet or mobile.
ludocid字符串可选
Decimal Google CID for a local entity search. Can replace q.
示例：1234567890123456789
sclient字符串可选
Google client label such as gws-wiz-serp: up to 64 letters, digits, dots, underscores, or hyphens.
timeout数字可选
Optional budget for the entire request in seconds, measured from gateway receipt until the response is ready to send. Includes admission, queueing and settlement. Must be greater than 0 and at most 90. On expiry, the call is not billed and returns 503 request_deadline_exceeded with retryable=true and a request ID. Omit to retain the standard server deadline.
location字符串可选
Human-readable search location, up to 512 characters. Use only one of location, uule, or lat and lon.
示例：Austin, Texas, United States
peek_pws字符串可选
Google personalization companion flag: 0 or 1, forwarded to Google unchanged.
color_scheme字符串可选
Google's light or dark result presentation.
as_sitesearch字符串可选
Hostname to include or exclude, such as example.com. A hostname, not a URL.
示例：example.com
google_domain字符串可选
A Google domain from Google's supported list, such as google.com or google.co.uk.
示例：google.com

代码示例

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

预览

curl -X GET 'https://toolswitch.dev/v1/tools/litescrape.google.serp.ai_overview?q=what+is+photosynthesis&gl=us&hl=en' \
  -H "X-Toolswitch-Key: $TOOLSWITCH_KEY"

import os
import requests

response = requests.request(
    "GET",
    "https://toolswitch.dev/v1/tools/litescrape.google.serp.ai_overview?q=what+is+photosynthesis&gl=us&hl=en",
    headers={"X-Toolswitch-Key": os.environ["TOOLSWITCH_KEY"]},
)
response.raise_for_status()
print(response.text)

const response = await fetch("https://toolswitch.dev/v1/tools/litescrape.google.serp.ai_overview?q=what+is+photosynthesis&gl=us&hl=en", {
  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 计费，已含服务费。