SerpApi Official

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

Actions72

Search Actions

Overview

This node enables users to perform live Google Search queries using the SerpApi service, specifically through the "Google Light" search engine option. It is designed to fetch structured search results from Google with various customizable parameters such as query text, location, language, and filtering options.

Common scenarios where this node is beneficial include:

Automating data collection for SEO or market research by retrieving Google search results programmatically.
Integrating Google search capabilities into workflows without manual browsing.
Filtering search results based on geographic location, language, or specific content requirements.

For example, a user can search for "coffee shops" in a specific city, limit results to a particular language, or exclude certain sites from the results.

Properties

Name	Meaning
Search Query (q)	The main search query string you want to look up on Google. Example: "coffee".
Location (location)	Defines the geographic location from which the search should originate. See SerpApi's locations API for supported values.
Encoded Location (uule)	Google encoded location parameter; cannot be used together with `location`.
Domain (google_domain)	Specifies the Google domain to use for the search, e.g., google.com, google.co.uk, google.de, etc.
Country (gl)	Country code to tailor the search results to a specific country, e.g., "us" for United States, "de" for Germany.
Language (hl)	Language code to specify the language of the search interface and results, e.g., "en" for English, "fr" for French.
Set Multiple Languages (lr)	Allows limiting the search to one or multiple languages using language codes separated by "
Include/Exclude Site (as_dt)	Controls whether to include or exclude results from a specified site.
Required Phrase (as_epq)	A phrase that all documents in the search results must contain.
Excluded Word/Phrase (as_eq)	Words or phrases that should not appear in any document in the search results.
Link to URL (as_lq)	Ensures all search results contain a link to a particular URL.
Search Range Start (as_nlo)	Starting value for a numeric search range filter.
Search Range End (as_nhi)	Ending value for a numeric search range filter.
Additional Search Terms (as_oq)	Additional terms where each document must contain at least one of them.
Search Terms (as_q)	Additional search terms to check for in documents.
Time Period (as_qdr)	Limits search results to a specified time period (e.g., past day, week).
Related URL (as_rq)	Limits results to pages related to a specified URL.
Site Search (as_sitesearch)	Restricts results to pages from a given site or excludes them depending on `as_dt`.
Adult Content Filtering (safe)	Level of filtering for adult content; options are "active" or "off".
Exclude Auto-corrected Results (nfpr)	Whether to exclude results from auto-corrected queries when the original query is misspelled.
Results Filtering (filter)	Enables or disables filters for "Similar Results" and "Omitted Results".
Result Offset (start)	Offset for paginating results, specifying the starting result number.
Number of Results (num)	Maximum number of results to return (default 10).
Device (device)	Device type to simulate for the search: desktop, tablet, or mobile.
Disable Caching (no_cache)	Forces fetching new results instead of cached ones. Cannot be used with async.
Async (async)	Performs the search asynchronously, submitting the request and retrieving results later. Cannot be used with no_cache or on accounts with Ludicrous Speed enabled.
ZeroTrace Mode (zero_trace)	Enterprise-only mode to skip storing search parameters and metadata on SerpApi servers for privacy.
Output (output)	Format of the output: "json" for structured JSON (default) or "html" for raw HTML.
JSON Restrictor (json_restrictor)	Restricts fields returned in the JSON response, e.g., limiting to first 3 organic results with only title and snippet.

Output

The node outputs a JSON object containing the search results retrieved from SerpApi's Google Light engine. The structure typically includes fields such as organic search results, ads, related questions, and other metadata depending on the query and parameters.

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

No binary data output is indicated for this operation.

Dependencies

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

Troubleshooting

Invalid API Key or Missing Credential: The node requires a valid API key credential. Ensure the credential is set up correctly in n8n.
Conflicting Parameters: Using both location and uule parameters simultaneously will cause errors. Use only one.
Async and No Cache Conflict: Setting both async and no_cache to true is invalid. Choose one mode.
Exceeded Rate Limits: SerpApi enforces rate limits; exceeding them may result in errors or blocked requests.
Unsupported Location or Language Codes: Ensure that location and language codes conform to SerpApi's supported values.
Empty or Unexpected Results: Check query parameters for correctness and try adjusting filters or search terms.