SerpApi Official icon

SerpApi Official

Get live Google Search data and more from SerpApi's official node

Actions37

Search → Google Shopping

AI-generated

Overview

This node performs a Google Shopping search using the SerpApi service. It allows users to input a search query and various optional parameters to customize the search, such as location, language, domain, filters, and more. The node sends a request to SerpApi's Google Shopping engine and retrieves live shopping search results from Google.

Use Case Examples

  1. A user wants to find the latest prices and product details for 'Coffee' on Google Shopping, specifying a location and language to get localized results.
  2. A user needs to filter Google Shopping results by a specific domain or apply advanced search filters like price range or product category.

Properties

Name Meaning
Search Query (q) Defines the query you want to search for in Google Shopping.
Location (location) Defines the geographic location from where the search should originate.
Encoded Location (uule) Google encoded location parameter for the search; cannot be used together with 'location'.
Domain (google_domain) Defines the Google domain to use for the search, e.g., google.com, google.co.uk.
Country (gl) Defines the country to use for the Google search, e.g., us, uk, fr.
Language (hl) Defines the language to use for the search, e.g., en, fr, es.
as_dt Controls whether to include or exclude results from the site named in the as_sitesearch parameter.
as_epq Identifies a phrase that all documents in the search results must contain.
as_eq Identifies a word or phrase that should not appear in any documents in the search results.
as_lq Specifies that all search results should contain a link to a particular URL.
as_nlo Specifies the starting value for a search range.
as_nhi Specifies the ending value for a search range.
as_oq Provides additional search terms to check for in a document, where each document must contain at least one of the terms.
as_q Provides search terms to check for in a document, commonly used to specify additional terms within a set of search results.
as_qdr Requests search results from a specified time period (quick date range).
as_rq Specifies that all search results should be pages related to the specified URL.
as_sitesearch Specifies that all search results should be pages from a given site or exclude pages from a given site if used with as_dt.
Advanced Search Parameters (tbs) Defines advanced search parameters not possible in the regular query field.
Search Filter ID (shoprs) Defines the helper ID for setting search filters in Google Shopping.
Include Direct Link (direct_link) Whether the search results should include direct links to each product; default is false.
Result Offset (start) Defines the result offset to skip a given number of results.
Number of Results (num) Defines the maximum number of results to return.
Device (device) Defines the device type to use for the search: desktop, tablet, or mobile.
Disable Caching (no_cache) Whether to force fetching new results instead of using cached results; default is false.
Async (async) Whether to perform the search asynchronously; default is false.
ZeroTrace Mode (zero_trace) Whether to enable ZeroTrace mode to skip storing search parameters and metadata; default is false.
Output (output) Defines the final output format: JSON (structured) or HTML (raw).
JSON Restrictor (json_restrictor) Defines fields to restrict in the response, e.g., limiting to certain result fields.

Output

JSON

  • search_metadata - Metadata about the search request and response.
  • shopping_results - Array of shopping product results returned by the search.
  • organic_results - Array of organic search results related to the query.
  • pagination - Information about pagination of the search results.

Dependencies

  • SerpApi service with an API key credential

Troubleshooting

  • Ensure the API key credential for SerpApi is correctly configured and valid.
  • Check that the search query parameter 'q' is provided and not empty, as it is required.
  • Avoid using conflicting parameters such as 'location' and 'uule' together, as they are mutually exclusive.
  • If using async search, be aware that it requires retrieving results later via the Search Archive API and is not compatible with caching or certain account types.
  • Verify that the domain and country codes are valid and supported by SerpApi for Google Shopping searches.
  • If the node returns errors related to SSL, consider enabling the option to ignore SSL issues if appropriate.

Links

Discussion