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. 9. 29.Verified 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이며 서비스 수수료가 포함되어 있습니다.