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/successAu prix du fournisseur
- 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
Paramètres
A 200 with ai_overview:null and search_metadata.ai_overview_state=not_served is unbilled by Litescrape.
| Paramètre | Type | Obligatoire | Description | Exemple |
|---|---|---|---|---|
| Paramètres de requête | ||||
q | chaîne | Facultatif | Search query, up to 2,048 characters. Required unless ludocid or kgmid is supplied. | coffee shops in Austin |
cr | chaîne | Facultatif | Country restriction: one or more countryXX values joined with |, such as countryUS. | countryUS |
gl | chaîne | Facultatif | Lowercase two-letter country code used to localize results. | us |
hl | chaîne | Facultatif | Google interface and result language, such as en, en-US, or de. Defaults to en. | en |
lr | chaîne | Facultatif | Language restriction: one or more lang_xx values joined with |, such as lang_en. | lang_en |
oq | chaîne | Facultatif | Original query text from a Google URL, up to 2,048 characters; forwarded unchanged. | |
si | chaîne | Facultatif | Opaque cached Google search context, up to 4,096 characters. | |
ibp | chaîne | Facultatif | Google layout or expansion control, up to 4,096 characters. | |
lat | nombre | Facultatif | Latitude between -90 and 90. Supply with lon; conflicts with location and uule. | 30.2672 |
lon | nombre | Facultatif | Longitude between -180 and 180. Supply with lat; conflicts with location and uule. | -97.7431 |
num | entier | Facultatif | Requested result count, 1 to 10. A best-effort hint: Google may return fewer rows, and results are never padded. | |
pws | chaîne | Facultatif | Google personalization flag: 0 or 1. 0 asks for non-personalized results. | |
tbm | chaîne | Facultatif | Google vertical: lcl, vid, nws, shop, or pts. Google Images (isch) is rejected with 400 unsupported_search_vertical. | |
tbs | chaîne | Facultatif | Google search-filter string, such as qdr:w, up to 4,096 characters. | |
uds | chaîne | Facultatif | Opaque Google filter token, up to 4,096 characters. | |
as_q | chaîne | Facultatif | Additional terms that must all match, up to 2,048 characters. | |
lsig | chaîne | Facultatif | Opaque Google local or Knowledge Graph signature, up to 4,096 characters. | |
nfpr | chaîne | Facultatif | Set 1 to disable Google spelling auto-correction, or 0 to allow it. | |
safe | chaîne | Facultatif | Google adult-content filtering: active or off. | |
uule | chaîne | Facultatif | Pre-encoded Google location token, up to 2,048 characters. Use only one of location, uule, or lat and lon. | |
as_dt | chaîne | Facultatif | Include (i) or exclude (e) the as_sitesearch host. Requires as_sitesearch. | |
as_eq | chaîne | Facultatif | Words the results must not contain, up to 2,048 characters. | |
as_lq | chaîne | Facultatif | Return pages that link to this complete HTTP(S) URL. | |
as_oq | chaîne | Facultatif | Additional terms of which any may match, up to 2,048 characters. | |
as_rq | chaîne | Facultatif | Return pages related to this complete HTTP(S) URL. | |
gs_lp | chaîne | Facultatif | Opaque Google autocomplete-session value from a Google URL, up to 4,096 characters; forwarded unchanged. | |
kgmid | chaîne | Facultatif | Google Knowledge Graph machine ID, such as /m/0k8z. Can replace q. | /m/0k8z |
start | entier | Facultatif | Result offset for pagination. Defaults to 0. | 10 |
as_epq | chaîne | Facultatif | Exact phrase the results must contain, up to 2,048 characters. | |
as_nhi | entier | Facultatif | Upper bound of a number range. Supply with as_nlo. | |
as_nlo | entier | Facultatif | Lower bound of a number range. Supply with as_nhi. | |
as_qdr | chaîne | Facultatif | Date range: d, w, m, or y with an optional positive count, such as m3 for the past three months. | m3 |
device | chaîne | Facultatif | Google returns its real layout for the selected device: desktop, tablet, or mobile. | desktop |
filter | chaîne | Facultatif | Google similar-results filtering: 0 or 1. | |
radius | nombre | Facultatif | 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 | chaîne | Facultatif | Decimal Google CID for a local entity search. Can replace q. | 1234567890123456789 |
sclient | chaîne | Facultatif | Google client label such as gws-wiz-serp: up to 64 letters, digits, dots, underscores, or hyphens. | |
timeout | nombre | Facultatif | 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 | chaîne | Facultatif | Human-readable search location, up to 512 characters. Use only one of location, uule, or lat and lon. | Austin, Texas, United States |
peek_pws | chaîne | Facultatif | Google personalization companion flag: 0 or 1, forwarded to Google unchanged. | |
color_scheme | chaîne | Facultatif | Google's light or dark result presentation. | |
as_sitesearch | chaîne | Facultatif | Hostname to include or exclude, such as example.com. A hostname, not a URL. | example.com |
google_domain | chaîne | Facultatif | A Google domain from Google's supported list, such as google.com or google.co.uk. | google.com |
- Paramètres de requête
qchaîneFacultatifSearch query, up to 2,048 characters. Required unless ludocid or kgmid is supplied.
Exemple :
coffee shops in AustincrchaîneFacultatifCountry restriction: one or more countryXX values joined with |, such as countryUS.
Exemple :
countryUSglchaîneFacultatifLowercase two-letter country code used to localize results.
Exemple :
ushlchaîneFacultatifGoogle interface and result language, such as en, en-US, or de. Defaults to en.
Exemple :
enlrchaîneFacultatifLanguage restriction: one or more lang_xx values joined with |, such as lang_en.
Exemple :
lang_enoqchaîneFacultatifOriginal query text from a Google URL, up to 2,048 characters; forwarded unchanged.
sichaîneFacultatifOpaque cached Google search context, up to 4,096 characters.
ibpchaîneFacultatifGoogle layout or expansion control, up to 4,096 characters.
latnombreFacultatifLatitude between -90 and 90. Supply with lon; conflicts with location and uule.
Exemple :
30.2672lonnombreFacultatifLongitude between -180 and 180. Supply with lat; conflicts with location and uule.
Exemple :
-97.7431numentierFacultatifRequested result count, 1 to 10. A best-effort hint: Google may return fewer rows, and results are never padded.
pwschaîneFacultatifGoogle personalization flag: 0 or 1. 0 asks for non-personalized results.
tbmchaîneFacultatifGoogle vertical: lcl, vid, nws, shop, or pts. Google Images (isch) is rejected with 400 unsupported_search_vertical.
tbschaîneFacultatifGoogle search-filter string, such as qdr:w, up to 4,096 characters.
udschaîneFacultatifOpaque Google filter token, up to 4,096 characters.
as_qchaîneFacultatifAdditional terms that must all match, up to 2,048 characters.
lsigchaîneFacultatifOpaque Google local or Knowledge Graph signature, up to 4,096 characters.
nfprchaîneFacultatifSet 1 to disable Google spelling auto-correction, or 0 to allow it.
safechaîneFacultatifGoogle adult-content filtering: active or off.
uulechaîneFacultatifPre-encoded Google location token, up to 2,048 characters. Use only one of location, uule, or lat and lon.
as_dtchaîneFacultatifInclude (i) or exclude (e) the as_sitesearch host. Requires as_sitesearch.
as_eqchaîneFacultatifWords the results must not contain, up to 2,048 characters.
as_lqchaîneFacultatifReturn pages that link to this complete HTTP(S) URL.
as_oqchaîneFacultatifAdditional terms of which any may match, up to 2,048 characters.
as_rqchaîneFacultatifReturn pages related to this complete HTTP(S) URL.
gs_lpchaîneFacultatifOpaque Google autocomplete-session value from a Google URL, up to 4,096 characters; forwarded unchanged.
kgmidchaîneFacultatifGoogle Knowledge Graph machine ID, such as /m/0k8z. Can replace q.
Exemple :
/m/0k8zstartentierFacultatifResult offset for pagination. Defaults to 0.
Exemple :
10as_epqchaîneFacultatifExact phrase the results must contain, up to 2,048 characters.
as_nhientierFacultatifUpper bound of a number range. Supply with as_nlo.
as_nloentierFacultatifLower bound of a number range. Supply with as_nhi.
as_qdrchaîneFacultatifDate range: d, w, m, or y with an optional positive count, such as m3 for the past three months.
Exemple :
m3devicechaîneFacultatifGoogle returns its real layout for the selected device: desktop, tablet, or mobile.
Exemple :
desktopfilterchaîneFacultatifGoogle similar-results filtering: 0 or 1.
radiusnombreFacultatifSearch 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.
ludocidchaîneFacultatifDecimal Google CID for a local entity search. Can replace q.
Exemple :
1234567890123456789sclientchaîneFacultatifGoogle client label such as gws-wiz-serp: up to 64 letters, digits, dots, underscores, or hyphens.
timeoutnombreFacultatifOptional 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.
locationchaîneFacultatifHuman-readable search location, up to 512 characters. Use only one of location, uule, or lat and lon.
Exemple :
Austin, Texas, United Statespeek_pwschaîneFacultatifGoogle personalization companion flag: 0 or 1, forwarded to Google unchanged.
color_schemechaîneFacultatifGoogle's light or dark result presentation.
as_sitesearchchaîneFacultatifHostname to include or exclude, such as example.com. A hostname, not a URL.
Exemple :
example.comgoogle_domainchaîneFacultatifA Google domain from Google's supported list, such as google.com or google.co.uk.
Exemple :
google.com
Exemples de code
Remplacez $TOOLSWITCH_KEY par la clé créée dans la 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());Cette API de passerelle est en préversion ; son URL et son authentification peuvent changer. Les paramètres de l’exemple sont des données fictives. Les appels sont facturés à $0.00015/success, frais de service inclus.