SerpApi Official icon

SerpApi Official

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

Actions72

Overview

This node enables users to perform live Google Shopping searches using SerpApi's official API. It is designed to fetch real-time product data from Google Shopping, which can be useful for market research, price comparison, competitor analysis, or e-commerce product discovery.

Typical use cases include:

  • Retrieving product listings for a specific search query (e.g., "Coffee") to analyze pricing and availability.
  • Filtering results by location, language, or device type to tailor the search to specific markets or user contexts.
  • Extracting structured product information such as titles, prices, and direct links for integration into other workflows or databases.

For example, an e-commerce manager could use this node to automatically gather competitor pricing on coffee machines in the US market, or a marketer might track trending products in different countries.

Properties

Name Meaning
Search Query (q) The main search term or phrase to query Google Shopping with. Example: "Coffee".
Location (location) Geographic location from where the search should originate. See SerpApi locations documentation for supported values.
Additional Fields A collection of optional parameters to refine the search:
- Encoded Location (uule) Google encoded location string; cannot be used together with location.
- Domain (google_domain) Google domain to use for the search, e.g., google.com, google.co.uk, etc.
- Country (gl) Country code to use for the search, e.g., "us" for United States, "gb" for United Kingdom.
- Language (hl) Language code for the search results, e.g., "en" for English, "fr" for French.
- as_dt Controls inclusion/exclusion of results from a specified site.
- as_epq Phrase that all documents in results must contain.
- as_eq Word or phrase that should not appear in any document in results.
- as_lq All results should contain a link to this URL.
- as_nlo Starting value for a numeric search range.
- as_nhi Ending value for a numeric search range.
- as_oq Additional search terms where each result must contain at least one.
- as_q Additional search terms to check within results.
- as_qdr Time period filter for results (quick date range).
- as_rq Results related to the specified URL.
- as_sitesearch Restrict results to pages from a given site.
- Advanced Search Parameters (tbs) Advanced search parameters not possible in regular query field.
- Search Filter ID (shoprs) Helper ID for setting search filters.
- Include Direct Link (direct_link) Boolean to include direct product links in results; default false. Applies only to new layout in some countries.
- Result Offset (start) Number of results to skip (offset).
- Number of Results (num) Maximum number of results to return.
- Device (device) Device type for search results: "desktop" (default), "tablet", or "mobile".
- Disable Caching (no_cache) Boolean to force fresh results ignoring cache; default false. Cannot be used with async.
- Async (async) Boolean to perform search asynchronously; default false. Cannot be used with no_cache or on accounts with Ludicrous Speed enabled.
- ZeroTrace Mode (zero_trace) Enterprise-only boolean to skip storing search metadata on SerpApi servers; default false.
- Output (output) Format of final output: "json" (default) for structured JSON, or "html" for raw HTML.
- JSON Restrictor (json_restrictor) Restricts fields returned in response, e.g., organic_results[0:3].{title,snippet} returns title and snippet of first 3 organic results.

Output

The node outputs a JSON object containing the structured results of the Google Shopping search. This includes product details such as titles, prices, images, store names, ratings, and possibly direct product links if requested.

If the output format is set to "html," the raw HTML content of the search results page is returned instead.

No binary data output is indicated for this operation.

Dependencies

  • Requires an active SerpApi account and a valid API key credential configured in n8n.
  • Internet access to call the SerpApi endpoint at https://serpapi.com/search.json.
  • Proper configuration of the API key credential in n8n to authenticate requests.

Troubleshooting

  • Invalid API Key or Authentication Errors: Ensure the API key credential is correctly set up and has permissions for Google Shopping searches.
  • Empty or Unexpected Results: Verify the search query and parameters are valid and supported by SerpApi. Check location, language, and domain settings.
  • Conflicting Parameters: Do not use uule and location parameters together as they are mutually exclusive.
  • Caching Issues: If results do not update, consider setting Disable Caching (no_cache) to true to force fresh data.
  • Async Usage Restrictions: Avoid using async parameter with no_cache or on accounts with Ludicrous Speed enabled.
  • Rate Limits or Quotas: Monitor your SerpApi usage to avoid exceeding monthly search limits.

Links and References

Discussion