SerpApi Official icon

SerpApi Official

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

Overview

This node integrates with SerpApi's Google Product API to retrieve detailed product information from Google Shopping results. It allows users to fetch live data about a specific product by its unique product ID, including offers, specifications, reviews, and other related details.

Common scenarios where this node is beneficial include:

  • E-commerce analytics: Gathering competitive pricing, offers, and reviews for products.
  • Market research: Extracting product specs and customer feedback from Google Shopping.
  • Price comparison tools: Automating retrieval of current offers and sellers for a product.
  • Inventory monitoring: Tracking availability and offers from various online sellers.

For example, you can input a product ID found in a Google Shopping URL to get structured JSON data about that product, including seller offers and customer reviews, which can then be used to update your own product listings or analyze market trends.

Properties

Name Meaning
Product ID (product_id) The unique identifier of the product to query. Usually found in Google Shopping URLs (e.g., https://www.google.com/shopping/product/{product_id}). This is required.
Additional Fields A collection of optional parameters to customize the search:
- Location (location) Origin location for the search. See SerpApi locations documentation for supported values.
- Encoded Location (uule) Google encoded location string. Cannot be used together with location.
- Domain (google_domain) Google domain to use for the search. Default is google.com. Many country-specific domains are available (e.g., google.co.uk, google.de).
- Country (gl) Country code to use for the search. Default is us. Supports a wide range of countries (e.g., us, gb, de, fr).
- Language (hl) Language code for the search results. Default is en (English). Many language options available (e.g., es for Spanish, fr for French).
- Result Offset (start) Offset for offers results pagination; skips the given number of results.
- Start From Page (page) Page number for online sellers results (10 results per page). Deprecated for reviews.
- Offers Results (offers) Boolean flag to fetch offers results. Cannot be used with offer_id.
- Fetch Specs Results (specs) Boolean flag to fetch product specifications. Cannot be used with offer_id.
- Fetch Reviews Results (reviews) Boolean flag to fetch product reviews. Cannot be used with offer_id.
- Advanced Filter Parameter (filter) String to define filters, sorting, and pagination for reviews and offers. See SerpApi docs for syntax.
- Offer ID (offer_id) ID to fetch multiple offers from an online seller. Found inside sellers_results.online_sellers. Cannot be used with offers, specs, or reviews.
- Disable Caching (no_cache) Boolean to force fetching fresh results instead of cached ones. Cache expires after 1 hour. Defaults to false. Cannot be used with async.
- Async (async) Boolean to perform asynchronous search. If true, results must be retrieved later via Search Archive API. Defaults to false. Cannot be used with no_cache. Not compatible with Ludicrous Speed accounts.
- ZeroTrace Mode (zero_trace) Boolean to enable ZeroTrace mode (Enterprise only), which disables storing search parameters and metadata on SerpApi servers. Defaults to false.
- Output (output) Defines output format: json (default) for structured JSON results or html for raw HTML.
- JSON Restrictor (json_restrictor) String to restrict fields returned in the JSON response, e.g., organic_results[0:3].{title,snippet} returns only titles and snippets of first 3 organic results.

Output

The node outputs a JSON object containing detailed information about the specified Google product. The structure includes:

  • Product details such as title, description, images, price, and ratings.
  • Offers from various online sellers, if requested.
  • Product specifications, if requested.
  • Customer reviews, if requested.
  • Metadata about the search and request.

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

The output does not include binary data.

Dependencies

  • Requires an active SerpApi account and a valid API key credential configured in n8n.
  • Internet access to call SerpApi endpoints.
  • No additional external dependencies beyond the SerpApi service.

Troubleshooting

  • Missing or invalid Product ID: Ensure the product_id parameter is correctly set and corresponds to a valid Google Shopping product.
  • Conflicting parameters: Parameters like offer_id cannot be used together with offers, specs, or reviews. Using them together will cause errors.
  • Cache conflicts: Do not use no_cache and async parameters simultaneously.
  • Async usage: When using async mode, results are not immediately available and must be fetched later via the Search Archive API.
  • API limits: Exceeding SerpApi quota or rate limits will result in errors. Monitor your usage accordingly.
  • Invalid location or language codes: Use supported values as per SerpApi documentation to avoid errors.
  • ZeroTrace mode: Enabling ZeroTrace may make debugging difficult due to lack of stored metadata.

Links and References

Discussion