SerpApi Official

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

Actions72

Search Actions

Overview

This node integrates with SerpApi's official API to perform live Google Shopping searches. It allows users to query Google Shopping data programmatically, retrieving product listings and related information based on search queries and various filtering parameters.

Common scenarios where this node is beneficial include:

E-commerce market research: Automatically gather product pricing, availability, and competitor data.
Price comparison tools: Fetch up-to-date product listings for comparison across different sellers.
Product trend analysis: Monitor popular products or categories over time.
Automated alerts: Trigger workflows when specific products appear or change in Google Shopping results.

For example, a user can input a search term like "Coffee" and receive structured data about coffee-related products available on Google Shopping, including prices, sellers, and direct links.

Properties

Name	Meaning
Search Query (q)	The main search term or query string to look for in Google Shopping (e.g., "Coffee"). This is required.
Location (location)	The geographic location from which the search should originate. See SerpApi's locations API documentation for supported values.
Encoded Location (uule)	Google encoded location parameter for specifying search location. Cannot be used together with `location`.
Domain (google_domain)	The Google domain to use for the search, e.g., google.com, google.co.uk, google.de, etc. A long list of country-specific Google domains is supported. Default is `google.com`.
Country (gl)	The country code to use for the Google search, such as `us` for United States, `gb` for United Kingdom, `de` for Germany, etc.
Language (hl)	The language code for the search results, e.g., `en` for English, `fr` for French, `es` for Spanish, etc.
as_dt	Controls whether to include or exclude results from the site named in the `as_sitesearch` parameter.
as_epq	Phrase that all documents in the search results must contain.
as_eq	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	Starting value for a search range; used with `as_nhi` to define an inclusive range.
as_nhi	Ending value for a search range; used with `as_nlo` to define an inclusive range.
as_oq	Additional search terms where each document must contain at least one of these terms (Boolean OR).
as_q	Additional search terms to check for in a document.
as_qdr	Requests search results from a specified time period (quick date range). See SerpApi docs for details.
as_rq	Specifies that all search results should be pages related to the specified URL.
as_sitesearch	Limits search results to pages from a given site. Can be combined with `as_dt` to exclude pages from that site.
Advanced Search Parameters (tbs)	Defines advanced search parameters not possible in the regular query field.
Search Filter ID (shoprs)	Helper ID for setting search filters. See SerpApi docs for more info.
Include Direct Link (direct_link)	Whether to include the direct link of each product in the results. Defaults to false. Only applies to new layout in some countries.
Result Offset (start)	Number of results to skip before starting to return results (pagination offset).
Number of Results (num)	Maximum number of results to return.
Device (device)	Device type to simulate for the search: `desktop` (default), `tablet`, or `mobile`.
Disable Caching (no_cache)	If true, forces fetching fresh results instead of cached ones. Cached results expire after 1 hour. Cannot be used with `async`.
Async (async)	If true, performs the search asynchronously, submitting it and retrieving results later via Search Archive API. Cannot be used with `no_cache`. Not recommended for accounts with Ludicrous Speed enabled.
ZeroTrace Mode (zero_trace)	Enterprise-only mode to skip storing search parameters and metadata on SerpApi servers for privacy. Defaults to false.
Output (output)	Format of the final output: `json` (default) for structured JSON results, or `html` for raw HTML retrieved.
JSON Restrictor (json_restrictor)	Restricts fields returned in the response, e.g., limiting to certain result items or fields.

Output

The node outputs a JSON object containing the Google Shopping search results as returned by SerpApi. The structure typically includes:

shopping_results: An array of product objects, each containing details such as:
- Product title
- Price and currency
- Store or seller name
- Product thumbnail image URL
- Product link (may be direct if direct_link is true)
- Ratings and reviews (if available)
- Other metadata depending on the query and filters

If the output property is set to html, the node returns the raw HTML content of the search results page instead of structured JSON.

The node does not output binary data.

Dependencies

Requires an active SerpApi account and an API key credential configured in n8n.
The node makes HTTP requests to SerpApi's endpoint https://serpapi.com/search.json.
Proper configuration of the API key credential in n8n is necessary for authentication.
Network access to SerpApi's service must be available.

Troubleshooting

Invalid API Key or Authentication Errors: Ensure the API key credential is correctly set up and valid.
Empty or Missing Results: Check that the search query (q) is provided and valid. Also verify location and other filters do not overly restrict results.
Conflicting Parameters: For example, using both location and uule parameters simultaneously will cause errors. Use only one location parameter.
Caching Issues: If results seem stale, consider setting no_cache to true to force fresh data retrieval.
Async Mode Usage: When async is true, results are not immediately available. You must retrieve them later via the Search Archive API. Avoid using async with no_cache.
Unsupported Domains or Locations: Verify that the selected google_domain, gl (country), and hl (language) values are supported by SerpApi.
Rate Limits or Quotas: Exceeding your SerpApi plan limits may cause request failures.