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

OperationVersionMethodPathOpenAPI summaryshoppingSearch``v1``GET``/api/v1/google/shopping/searchSearch

Inputs#

ParameterInRequired byOptional byTypeNotescountry``queryn/aallstringSet the target country code (e.g., 'us', 'uk') to localize results. See Google Countriesdomain``queryn/aallstringThe Google domain to use for the search (e.g., 'google.com', 'google.co.uk'). See Google Domainshtml``queryn/aallbooleanSet to true to return the raw HTML of the Google search results page alongside the structured datalanguage``queryn/aallstringSet the language for the results using its two-letter code (e.g., 'en' for English, 'fr' for French). See Google Languagelr``queryn/aallstringRestrict results to one or more languages using the 'lang_{language_code}' format (e.g., 'lang_en'). See Google LR Languagenfpr``queryn/aallstringControls Google's auto-correction. Set to '1' to exclude corrected results, '0' to include thempage``queryn/aallintegerThe results page number. Use 0 for the first page, 1 for the second, and so onquery``queryalln/astringThe shopping search query (e.g., 'iPhone 15', 'running shoes')safe``queryn/aallstringSafeSearch filter setting. Set to 'active' to filter adult content, or 'off' to disable itshoprs``queryn/aallstringA unique ID used to apply specific shopping filters. Usually obtained from previous responsetbs``queryn/aallstringAdvanced 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 emptyuule``queryn/aallstringEncoded 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.

bash

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 shoppingSearch on /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.