Google SERP Shopping Search
Use this focused Just Serp API skill for Google SERP Shopping Search. It targets GET /api/v1/google/shopping/search. Required inputs are query. OpenAPI describes it as: Get Google shopping Search data, including product listings, prices, and merchants, for pricing research and catalog monitoring.
Endpoint Scope
- Group key:
google - Endpoint key:
shopping/search - Group family: Google SERP
- Skill slug:
justserpapi-google-shopping-search
| Operation | Version | Method | Path | OpenAPI summary |
|---|---|---|---|---|
shoppingSearch |
v1 |
GET |
/api/v1/google/shopping/search |
Search |
Inputs
| Parameter | In | Required by | Optional by | Type | Notes |
|---|---|---|---|---|---|
country |
query |
n/a | all | string |
Set the target country code (e.g., 'us', 'uk') to localize results. See Google Countries |
domain |
query |
n/a | all | string |
The Google domain to use for the search (e.g., 'google.com', 'google.co.uk'). See Google Domains |
html |
query |
n/a | all | boolean |
Set to true to return the raw HTML of the Google search results page alongside the structured data |
language |
query |
n/a | all | string |
Set the language for the results using its two-letter code (e.g., 'en' for English, 'fr' for French). See Google Language |
lr |
query |
n/a | all | string |
Restrict results to one or more languages using the 'lang_{language_code}' format (e.g., 'lang_en'). See Google LR Language |
nfpr |
query |
n/a | all | string |
Controls Google's auto-correction. Set to '1' to exclude corrected results, '0' to include them |
page |
query |
n/a | all | integer |
The results page number. Use 0 for the first page, 1 for the second, and so on |
query |
query |
all | n/a | string |
The shopping search query (e.g., 'iPhone 15', 'running shoes') |
safe |
query |
n/a | all | string |
SafeSearch filter setting. Set to 'active' to filter adult content, or 'off' to disable it |
shoprs |
query |
n/a | all | string |
A unique ID used to apply specific shopping filters. Usually obtained from previous response |
tbs |
query |
n/a | all | string |
Advanced search filter parameter (tbs) used to apply Google result filters (e.g. time range). This is an advanced parameter — if you’re not familiar with it, you can leave it empty |
uule |
query |
n/a | all | string |
Encoded location string (UULE) used to precisely localize Google search results. This is an advanced/technical parameter — if you’re not familiar with it, you can leave it empty and omit it |
Request body: none documented; send parameters through path or query arguments.
Version Choice
Use shoppingSearch for the documented v1 endpoint. There are no alternate versions grouped in this skill.
Run This Endpoint
Supported operation IDs in this skill: shoppingSearch.
node {baseDir}/bin/run.mjs --operation "shoppingSearch" --api-key "$JUST_SERP_API_KEY" --params-json '{"query":"<query>"}'
Ask for any missing required parameter before calling the helper. Keep user-provided IDs, URLs, keywords, and filters unchanged.
Environment
- Required:
JUST_SERP_API_KEY - Pass the API key with
--api-key "$JUST_SERP_API_KEY"; do not paste key values into chat messages, screenshots, or logs. - Project site: Just Serp API.
- Authentication details: Just Serp API Docs.
Output Focus
- State the operation ID and endpoint path used, for example
shoppingSearchon/api/v1/google/shopping/search. - Echo the required lookup scope (
query) before summarizing results. - Prioritize fields that support this endpoint purpose: Get Google shopping Search data, including product listings, prices, and merchants, for pricing research and catalog monitoring.
- Return raw JSON only after the short, endpoint-specific summary.
- If the backend errors, include the backend payload and the exact operation ID.