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/successプロバイダー原価
- Success rate
- 55.4%Last 30 days · 13,926 calls
- Latency p50
- 7.5 sp95 49 s
- Last verified
- 2026/09/29Verified 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
パラメータ
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 Austincr文字列任意Country restriction: one or more countryXX values joined with |, such as countryUS.
例:
countryUSgl文字列任意Lowercase two-letter country code used to localize results.
例:
ushl文字列任意Google interface and result language, such as en, en-US, or de. Defaults to en.
例:
enlr文字列任意Language restriction: one or more lang_xx values joined with |, such as lang_en.
例:
lang_enoq文字列任意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.2672lon数値任意Longitude between -180 and 180. Supply with lat; conflicts with location and uule.
例:
-97.7431num整数任意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/0k8zstart整数任意Result offset for pagination. Defaults to 0.
例:
10as_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.
例:
m3device文字列任意Google returns its real layout for the selected device: desktop, tablet, or mobile.
例:
desktopfilter文字列任意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.
例:
1234567890123456789sclient文字列任意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 Statespeek_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.comgoogle_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());このゲートウェイ API はプレビュー版です。URL や認証方式は変更される場合があります。 パラメータはサンプルデータです。 呼び出し料金は $0.00015/success です。サービス料を含みます。