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/successAl precio del proveedor
- Success rate
- 55,4 %Last 30 days · 13.926 calls
- Latency p50
- 7.5 sp95 49 s
- Last verified
- 29 sept 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 | Obligatorio | Descripción | Ejemplo |
|---|---|---|---|---|
| Parámetros de consulta | ||||
q | cadena | Opcional | Search query, up to 2,048 characters. Required unless ludocid or kgmid is supplied. | coffee shops in Austin |
cr | cadena | Opcional | Country restriction: one or more countryXX values joined with |, such as countryUS. | countryUS |
gl | cadena | Opcional | Lowercase two-letter country code used to localize results. | us |
hl | cadena | Opcional | Google interface and result language, such as en, en-US, or de. Defaults to en. | en |
lr | cadena | Opcional | Language restriction: one or more lang_xx values joined with |, such as lang_en. | lang_en |
oq | cadena | Opcional | Original query text from a Google URL, up to 2,048 characters; forwarded unchanged. | |
si | cadena | Opcional | Opaque cached Google search context, up to 4,096 characters. | |
ibp | cadena | 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 | entero | Opcional | Requested result count, 1 to 10. A best-effort hint: Google may return fewer rows, and results are never padded. | |
pws | cadena | Opcional | Google personalization flag: 0 or 1. 0 asks for non-personalized results. | |
tbm | cadena | Opcional | Google vertical: lcl, vid, nws, shop, or pts. Google Images (isch) is rejected with 400 unsupported_search_vertical. | |
tbs | cadena | Opcional | Google search-filter string, such as qdr:w, up to 4,096 characters. | |
uds | cadena | Opcional | Opaque Google filter token, up to 4,096 characters. | |
as_q | cadena | Opcional | Additional terms that must all match, up to 2,048 characters. | |
lsig | cadena | Opcional | Opaque Google local or Knowledge Graph signature, up to 4,096 characters. | |
nfpr | cadena | Opcional | Set 1 to disable Google spelling auto-correction, or 0 to allow it. | |
safe | cadena | Opcional | Google adult-content filtering: active or off. | |
uule | cadena | Opcional | Pre-encoded Google location token, up to 2,048 characters. Use only one of location, uule, or lat and lon. | |
as_dt | cadena | Opcional | Include (i) or exclude (e) the as_sitesearch host. Requires as_sitesearch. | |
as_eq | cadena | Opcional | Words the results must not contain, up to 2,048 characters. | |
as_lq | cadena | Opcional | Return pages that link to this complete HTTP(S) URL. | |
as_oq | cadena | Opcional | Additional terms of which any may match, up to 2,048 characters. | |
as_rq | cadena | Opcional | Return pages related to this complete HTTP(S) URL. | |
gs_lp | cadena | Opcional | Opaque Google autocomplete-session value from a Google URL, up to 4,096 characters; forwarded unchanged. | |
kgmid | cadena | Opcional | Google Knowledge Graph machine ID, such as /m/0k8z. Can replace q. | /m/0k8z |
start | entero | Opcional | Result offset for pagination. Defaults to 0. | 10 |
as_epq | cadena | Opcional | Exact phrase the results must contain, up to 2,048 characters. | |
as_nhi | entero | Opcional | Upper bound of a number range. Supply with as_nlo. | |
as_nlo | entero | Opcional | Lower bound of a number range. Supply with as_nhi. | |
as_qdr | cadena | Opcional | Date range: d, w, m, or y with an optional positive count, such as m3 for the past three months. | m3 |
device | cadena | Opcional | Google returns its real layout for the selected device: desktop, tablet, or mobile. | desktop |
filter | cadena | 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 | cadena | Opcional | Decimal Google CID for a local entity search. Can replace q. | 1234567890123456789 |
sclient | cadena | 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 | cadena | 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 | cadena | Opcional | Google personalization companion flag: 0 or 1, forwarded to Google unchanged. | |
color_scheme | cadena | Opcional | Google's light or dark result presentation. | |
as_sitesearch | cadena | Opcional | Hostname to include or exclude, such as example.com. A hostname, not a URL. | example.com |
google_domain | cadena | Opcional | A Google domain from Google's supported list, such as google.com or google.co.uk. | google.com |
- Parámetros de consulta
qcadenaOpcionalSearch query, up to 2,048 characters. Required unless ludocid or kgmid is supplied.
Ejemplo:
coffee shops in AustincrcadenaOpcionalCountry restriction: one or more countryXX values joined with |, such as countryUS.
Ejemplo:
countryUSglcadenaOpcionalLowercase two-letter country code used to localize results.
Ejemplo:
ushlcadenaOpcionalGoogle interface and result language, such as en, en-US, or de. Defaults to en.
Ejemplo:
enlrcadenaOpcionalLanguage restriction: one or more lang_xx values joined with |, such as lang_en.
Ejemplo:
lang_enoqcadenaOpcionalOriginal query text from a Google URL, up to 2,048 characters; forwarded unchanged.
sicadenaOpcionalOpaque cached Google search context, up to 4,096 characters.
ibpcadenaOpcionalGoogle layout or expansion control, up to 4,096 characters.
latnúmeroOpcionalLatitude between -90 and 90. Supply with lon; conflicts with location and uule.
Ejemplo:
30.2672lonnúmeroOpcionalLongitude between -180 and 180. Supply with lat; conflicts with location and uule.
Ejemplo:
-97.7431numenteroOpcionalRequested result count, 1 to 10. A best-effort hint: Google may return fewer rows, and results are never padded.
pwscadenaOpcionalGoogle personalization flag: 0 or 1. 0 asks for non-personalized results.
tbmcadenaOpcionalGoogle vertical: lcl, vid, nws, shop, or pts. Google Images (isch) is rejected with 400 unsupported_search_vertical.
tbscadenaOpcionalGoogle search-filter string, such as qdr:w, up to 4,096 characters.
udscadenaOpcionalOpaque Google filter token, up to 4,096 characters.
as_qcadenaOpcionalAdditional terms that must all match, up to 2,048 characters.
lsigcadenaOpcionalOpaque Google local or Knowledge Graph signature, up to 4,096 characters.
nfprcadenaOpcionalSet 1 to disable Google spelling auto-correction, or 0 to allow it.
safecadenaOpcionalGoogle adult-content filtering: active or off.
uulecadenaOpcionalPre-encoded Google location token, up to 2,048 characters. Use only one of location, uule, or lat and lon.
as_dtcadenaOpcionalInclude (i) or exclude (e) the as_sitesearch host. Requires as_sitesearch.
as_eqcadenaOpcionalWords the results must not contain, up to 2,048 characters.
as_lqcadenaOpcionalReturn pages that link to this complete HTTP(S) URL.
as_oqcadenaOpcionalAdditional terms of which any may match, up to 2,048 characters.
as_rqcadenaOpcionalReturn pages related to this complete HTTP(S) URL.
gs_lpcadenaOpcionalOpaque Google autocomplete-session value from a Google URL, up to 4,096 characters; forwarded unchanged.
kgmidcadenaOpcionalGoogle Knowledge Graph machine ID, such as /m/0k8z. Can replace q.
Ejemplo:
/m/0k8zstartenteroOpcionalResult offset for pagination. Defaults to 0.
Ejemplo:
10as_epqcadenaOpcionalExact phrase the results must contain, up to 2,048 characters.
as_nhienteroOpcionalUpper bound of a number range. Supply with as_nlo.
as_nloenteroOpcionalLower bound of a number range. Supply with as_nhi.
as_qdrcadenaOpcionalDate range: d, w, m, or y with an optional positive count, such as m3 for the past three months.
Ejemplo:
m3devicecadenaOpcionalGoogle returns its real layout for the selected device: desktop, tablet, or mobile.
Ejemplo:
desktopfiltercadenaOpcionalGoogle 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.
ludocidcadenaOpcionalDecimal Google CID for a local entity search. Can replace q.
Ejemplo:
1234567890123456789sclientcadenaOpcionalGoogle 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.
locationcadenaOpcionalHuman-readable search location, up to 512 characters. Use only one of location, uule, or lat and lon.
Ejemplo:
Austin, Texas, United Statespeek_pwscadenaOpcionalGoogle personalization companion flag: 0 or 1, forwarded to Google unchanged.
color_schemecadenaOpcionalGoogle's light or dark result presentation.
as_sitesearchcadenaOpcionalHostname to include or exclude, such as example.com. A hostname, not a URL.
Ejemplo:
example.comgoogle_domaincadenaOpcionalA Google domain from Google's supported list, such as google.com or google.co.uk.
Ejemplo:
google.com
Ejemplos de código
Sustituye $TOOLSWITCH_KEY por la clave que creaste en la consola.
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());La API de la pasarela está en versión preliminar; su URL y autenticación pueden cambiar. Los parámetros del ejemplo son datos de muestra. Las llamadas se facturan a $0.00015/success, incluida la tarifa de servicio.