Search Google Shopping
litescrape.google.serp.shoppingReturns the Google Shopping product grid, category blocks, sponsored listings and refinement filters
- Price
- $0.00015/successプロバイダー原価
- Success rate
- 9.9%Last 30 days · 216,867 calls
- Latency p50
- 1.7 sp95 4.5 s
- Last verified
- 2026/09/29Verified working
GEThttps://toolswitch.dev/v1/tools/litescrape.google.serp.shopping?q=coffee+makerPreview- Uses platform quota
- Synchronous response
- Reads public data
パラメータ
| パラメータ | 型 | 必須 | 説明 | 例 |
|---|---|---|---|---|
| クエリパラメータ | ||||
q | 文字列 | 任意 | Product search term, up to 2,048 characters. Required unless shoprs is supplied. This is a search, not an exact product ID lookup. | coffee maker |
gl | 文字列 | 任意 | Two-letter country code used to localize results. | us |
hl | 文字列 | 任意 | Language code such as en, en-GB, or de. | en |
num | 整数 | 任意 | Number of products to return. Google serves 40 products per page; a larger num reads further pages within the same call and returns fewer only when Google has no more products. | 60 |
uule | 文字列 | 任意 | Pre-encoded Google location token. Mutually exclusive with location. | |
start | 整数 | 任意 | Result offset. | |
device | 文字列 | 任意 | Google device layout. Each device is served Google's real layout for it. | |
shoprs | 文字列 | 任意 | Refinement token from a previous response's filters. An explicit refinement parameter replaces the refinement it carries. | |
on_sale | 真偽値 | 任意 | Show only products Google marks as on sale. Cannot be combined with another refinement. | |
sort_by | 文字列 | 任意 | Sort order: 1 price low to high, 2 price high to low, 3 rating high to low, 4 relevance (the default). Combines with any one refinement. | |
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, such as Austin, Texas. At most 63 UTF-8 bytes. Mutually exclusive with uule. | Austin, Texas |
max_price | 数値 | 任意 | Upper price bound in the storefront currency, at or above min_price. Cannot be combined with on_sale, free_shipping or small_business. | |
min_price | 数値 | 任意 | Lower price bound in the storefront currency. Cannot be combined with on_sale, free_shipping or small_business. | |
free_shipping | 真偽値 | 任意 | Show only products with free shipping. Cannot be combined with another refinement. | |
google_domain | 文字列 | 任意 | Google domain used for the request. | google.com |
small_business | 真偽値 | 任意 | Show only products from small businesses. Cannot be combined with another refinement. | |
- クエリパラメータ
q文字列任意Product search term, up to 2,048 characters. Required unless shoprs is supplied. This is a search, not an exact product ID lookup.
例:
coffee makergl文字列任意Two-letter country code used to localize results.
例:
ushl文字列任意Language code such as en, en-GB, or de.
例:
ennum整数任意Number of products to return. Google serves 40 products per page; a larger num reads further pages within the same call and returns fewer only when Google has no more products.
例:
60uule文字列任意Pre-encoded Google location token. Mutually exclusive with location.
start整数任意Result offset.
device文字列任意Google device layout. Each device is served Google's real layout for it.
shoprs文字列任意Refinement token from a previous response's filters. An explicit refinement parameter replaces the refinement it carries.
on_sale真偽値任意Show only products Google marks as on sale. Cannot be combined with another refinement.
sort_by文字列任意Sort order: 1 price low to high, 2 price high to low, 3 rating high to low, 4 relevance (the default). Combines with any one refinement.
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, such as Austin, Texas. At most 63 UTF-8 bytes. Mutually exclusive with uule.
例:
Austin, Texasmax_price数値任意Upper price bound in the storefront currency, at or above min_price. Cannot be combined with on_sale, free_shipping or small_business.
min_price数値任意Lower price bound in the storefront currency. Cannot be combined with on_sale, free_shipping or small_business.
free_shipping真偽値任意Show only products with free shipping. Cannot be combined with another refinement.
google_domain文字列任意Google domain used for the request.
例:
google.comsmall_business真偽値任意Show only products from small businesses. Cannot be combined with another refinement.
コード例
$TOOLSWITCH_KEY をコンソールで作成したキーに置き換えてください。
curl -X GET 'https://toolswitch.dev/v1/tools/litescrape.google.serp.shopping?q=coffee+maker' \
-H "X-Toolswitch-Key: $TOOLSWITCH_KEY"import os
import requests
response = requests.request(
"GET",
"https://toolswitch.dev/v1/tools/litescrape.google.serp.shopping?q=coffee+maker",
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.shopping?q=coffee+maker", {
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 です。サービス料を含みます。