Get Google AI Overview
litescrape.google.serp.ai_overviewReturns only the AI Overview from a Google results page, and accepts the Google Search parameters except fast_mode
- Price
- $0.00015/successPelo preço do provedor
- Success rate
- 55,4%Last 30 days · 13.926 calls
- Latency p50
- 7.5 sp95 49 s
- Last verified
- 29 de set. de 2026Verified working
GEThttps://toolswitch.dev/v1/tools/litescrape.google.serp.ai_overview?q=what+is+photosynthesis&gl=us&hl=enPreview- Uses platform quota
- Synchronous response
- Reads public data
Parâmetros
A 200 with ai_overview:null and search_metadata.ai_overview_state=not_served is unbilled by Litescrape.
| Parâmetro | Tipo | Obrigatório | Descrição | Exemplo |
|---|---|---|---|---|
| Parâmetros de consulta | ||||
q | string | Opcional | Search query, up to 2,048 characters. Required unless ludocid or kgmid is supplied. | coffee shops in Austin |
cr | string | Opcional | Country restriction: one or more countryXX values joined with |, such as countryUS. | countryUS |
gl | string | Opcional | Lowercase two-letter country code used to localize results. | us |
hl | string | Opcional | Google interface and result language, such as en, en-US, or de. Defaults to en. | en |
lr | string | Opcional | Language restriction: one or more lang_xx values joined with |, such as lang_en. | lang_en |
oq | string | Opcional | Original query text from a Google URL, up to 2,048 characters; forwarded unchanged. | |
si | string | Opcional | Opaque cached Google search context, up to 4,096 characters. | |
ibp | string | Opcional | Google layout or expansion control, up to 4,096 characters. | |
lat | número | Opcional | Latitude between -90 and 90. Supply with lon; conflicts with location and uule. | 30.2672 |
lon | número | Opcional | Longitude between -180 and 180. Supply with lat; conflicts with location and uule. | -97.7431 |
num | inteiro | Opcional | Requested result count, 1 to 10. A best-effort hint: Google may return fewer rows, and results are never padded. | |
pws | string | Opcional | Google personalization flag: 0 or 1. 0 asks for non-personalized results. | |
tbm | string | Opcional | Google vertical: lcl, vid, nws, shop, or pts. Google Images (isch) is rejected with 400 unsupported_search_vertical. | |
tbs | string | Opcional | Google search-filter string, such as qdr:w, up to 4,096 characters. | |
uds | string | Opcional | Opaque Google filter token, up to 4,096 characters. | |
as_q | string | Opcional | Additional terms that must all match, up to 2,048 characters. | |
lsig | string | Opcional | Opaque Google local or Knowledge Graph signature, up to 4,096 characters. | |
nfpr | string | Opcional | Set 1 to disable Google spelling auto-correction, or 0 to allow it. | |
safe | string | Opcional | Google adult-content filtering: active or off. | |
uule | string | Opcional | Pre-encoded Google location token, up to 2,048 characters. Use only one of location, uule, or lat and lon. | |
as_dt | string | Opcional | Include (i) or exclude (e) the as_sitesearch host. Requires as_sitesearch. | |
as_eq | string | Opcional | Words the results must not contain, up to 2,048 characters. | |
as_lq | string | Opcional | Return pages that link to this complete HTTP(S) URL. | |
as_oq | string | Opcional | Additional terms of which any may match, up to 2,048 characters. | |
as_rq | string | Opcional | Return pages related to this complete HTTP(S) URL. | |
gs_lp | string | Opcional | Opaque Google autocomplete-session value from a Google URL, up to 4,096 characters; forwarded unchanged. | |
kgmid | string | Opcional | Google Knowledge Graph machine ID, such as /m/0k8z. Can replace q. | /m/0k8z |
start | inteiro | Opcional | Result offset for pagination. Defaults to 0. | 10 |
as_epq | string | Opcional | Exact phrase the results must contain, up to 2,048 characters. | |
as_nhi | inteiro | Opcional | Upper bound of a number range. Supply with as_nlo. | |
as_nlo | inteiro | Opcional | Lower bound of a number range. Supply with as_nhi. | |
as_qdr | string | Opcional | Date range: d, w, m, or y with an optional positive count, such as m3 for the past three months. | m3 |
device | string | Opcional | Google returns its real layout for the selected device: desktop, tablet, or mobile. | desktop |
filter | string | Opcional | Google similar-results filtering: 0 or 1. | |
radius | número | Opcional | 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 | string | Opcional | Decimal Google CID for a local entity search. Can replace q. | 1234567890123456789 |
sclient | string | Opcional | Google client label such as gws-wiz-serp: up to 64 letters, digits, dots, underscores, or hyphens. | |
timeout | número | Opcional | 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 | string | Opcional | Human-readable search location, up to 512 characters. Use only one of location, uule, or lat and lon. | Austin, Texas, United States |
peek_pws | string | Opcional | Google personalization companion flag: 0 or 1, forwarded to Google unchanged. | |
color_scheme | string | Opcional | Google's light or dark result presentation. | |
as_sitesearch | string | Opcional | Hostname to include or exclude, such as example.com. A hostname, not a URL. | example.com |
google_domain | string | Opcional | A Google domain from Google's supported list, such as google.com or google.co.uk. | google.com |
- Parâmetros de consulta
qstringOpcionalSearch query, up to 2,048 characters. Required unless ludocid or kgmid is supplied.
Exemplo:
coffee shops in AustincrstringOpcionalCountry restriction: one or more countryXX values joined with |, such as countryUS.
Exemplo:
countryUSglstringOpcionalLowercase two-letter country code used to localize results.
Exemplo:
ushlstringOpcionalGoogle interface and result language, such as en, en-US, or de. Defaults to en.
Exemplo:
enlrstringOpcionalLanguage restriction: one or more lang_xx values joined with |, such as lang_en.
Exemplo:
lang_enoqstringOpcionalOriginal query text from a Google URL, up to 2,048 characters; forwarded unchanged.
sistringOpcionalOpaque cached Google search context, up to 4,096 characters.
ibpstringOpcionalGoogle layout or expansion control, up to 4,096 characters.
latnúmeroOpcionalLatitude between -90 and 90. Supply with lon; conflicts with location and uule.
Exemplo:
30.2672lonnúmeroOpcionalLongitude between -180 and 180. Supply with lat; conflicts with location and uule.
Exemplo:
-97.7431numinteiroOpcionalRequested result count, 1 to 10. A best-effort hint: Google may return fewer rows, and results are never padded.
pwsstringOpcionalGoogle personalization flag: 0 or 1. 0 asks for non-personalized results.
tbmstringOpcionalGoogle vertical: lcl, vid, nws, shop, or pts. Google Images (isch) is rejected with 400 unsupported_search_vertical.
tbsstringOpcionalGoogle search-filter string, such as qdr:w, up to 4,096 characters.
udsstringOpcionalOpaque Google filter token, up to 4,096 characters.
as_qstringOpcionalAdditional terms that must all match, up to 2,048 characters.
lsigstringOpcionalOpaque Google local or Knowledge Graph signature, up to 4,096 characters.
nfprstringOpcionalSet 1 to disable Google spelling auto-correction, or 0 to allow it.
safestringOpcionalGoogle adult-content filtering: active or off.
uulestringOpcionalPre-encoded Google location token, up to 2,048 characters. Use only one of location, uule, or lat and lon.
as_dtstringOpcionalInclude (i) or exclude (e) the as_sitesearch host. Requires as_sitesearch.
as_eqstringOpcionalWords the results must not contain, up to 2,048 characters.
as_lqstringOpcionalReturn pages that link to this complete HTTP(S) URL.
as_oqstringOpcionalAdditional terms of which any may match, up to 2,048 characters.
as_rqstringOpcionalReturn pages related to this complete HTTP(S) URL.
gs_lpstringOpcionalOpaque Google autocomplete-session value from a Google URL, up to 4,096 characters; forwarded unchanged.
kgmidstringOpcionalGoogle Knowledge Graph machine ID, such as /m/0k8z. Can replace q.
Exemplo:
/m/0k8zstartinteiroOpcionalResult offset for pagination. Defaults to 0.
Exemplo:
10as_epqstringOpcionalExact phrase the results must contain, up to 2,048 characters.
as_nhiinteiroOpcionalUpper bound of a number range. Supply with as_nlo.
as_nlointeiroOpcionalLower bound of a number range. Supply with as_nhi.
as_qdrstringOpcionalDate range: d, w, m, or y with an optional positive count, such as m3 for the past three months.
Exemplo:
m3devicestringOpcionalGoogle returns its real layout for the selected device: desktop, tablet, or mobile.
Exemplo:
desktopfilterstringOpcionalGoogle similar-results filtering: 0 or 1.
radiusnúmeroOpcionalSearch 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.
ludocidstringOpcionalDecimal Google CID for a local entity search. Can replace q.
Exemplo:
1234567890123456789sclientstringOpcionalGoogle client label such as gws-wiz-serp: up to 64 letters, digits, dots, underscores, or hyphens.
timeoutnúmeroOpcionalOptional 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.
locationstringOpcionalHuman-readable search location, up to 512 characters. Use only one of location, uule, or lat and lon.
Exemplo:
Austin, Texas, United Statespeek_pwsstringOpcionalGoogle personalization companion flag: 0 or 1, forwarded to Google unchanged.
color_schemestringOpcionalGoogle's light or dark result presentation.
as_sitesearchstringOpcionalHostname to include or exclude, such as example.com. A hostname, not a URL.
Exemplo:
example.comgoogle_domainstringOpcionalA Google domain from Google's supported list, such as google.com or google.co.uk.
Exemplo:
google.com
Exemplos de código
Substitua $TOOLSWITCH_KEY pela chave criada no console.
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());Esta API de gateway está em prévia; a URL e a autenticação podem mudar. Os parâmetros do exemplo são dados de amostra. As chamadas são cobradas a $0.00015/success, incluindo a taxa de serviço.