SerpApi Official icon

SerpApi Official

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

Actions72

Overview

This node provides an interface to perform Google Light searches using the SerpApi service. It allows users to send search queries to Google and retrieve structured search results in JSON or raw HTML format. This is useful for automating data extraction from Google search results without dealing with scraping complexities.

Common scenarios include:

  • Gathering search result data for SEO analysis.
  • Monitoring keyword rankings.
  • Extracting snippets, titles, and URLs from Google search results.
  • Integrating Google search data into workflows for content research or competitive analysis.

Example: You want to search for "coffee" and get the top 10 Google search results as structured JSON data for further processing.

Properties

Name Meaning
Search Query (q) The query string you want to search on Google. Example: "coffee".
Location (location) The geographic location from which the search should originate. See SerpApi locations API for supported values.
Additional Fields A collection of optional parameters to customize 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. Examples: google.com, google.co.uk, google.de, etc.
- Country (gl) Country code to use for the search. Examples: us, gb, de, fr, etc.
- Language (hl) Language code for the search interface. Examples: en, fr, de, es, etc.
- Set Multiple Languages (lr) Limit search to one or multiple languages using language codes separated by `
- Include/Exclude Site (as_dt) Control whether to include or exclude results from a specific site.
- Required Phrase (as_epq) Phrase that all documents must contain.
- Excluded Word/Phrase (as_eq) Words or phrases that should not appear in any document.
- Link to URL (as_lq) All results should contain a link to this URL.
- Search Range Start (as_nlo) Starting value for a numeric search range.
- Search Range End (as_nhi) Ending value for a numeric search range.
- Additional Search Terms (as_oq) Additional terms where each document must contain at least one.
- Search Terms (as_q) Search terms to check for in documents.
- Time Period (as_qdr) Restrict results to a specified time period (e.g., past day, week).
- Related URL (as_rq) Results related to the specified URL.
- Site Search (as_sitesearch) Restrict results to pages from a given site or exclude them based on as_dt.
- Adult Content Filtering (safe) Level of filtering for adult content. Options: Active, Off.
- Exclude Auto-corrected Results (nfpr) Whether to exclude results from auto-corrected queries. Boolean.
- Results Filtering (filter) Enable or disable filters for similar or omitted results. Boolean.
- Result Offset (start) Offset for the first result to return (pagination).
- Number of Results (num) Maximum number of results to return. Default is 10.
- Device (device) Device type to simulate: desktop, tablet, or mobile.
- Disable Caching (no_cache) Force fetching new results instead of cached ones. Boolean.
- Async (async) Perform search asynchronously. Boolean.
- ZeroTrace Mode (zero_trace) Enterprise mode to skip storing search metadata on servers. Boolean.
- Output (output) Format of the output: JSON (structured) or html (raw).
- JSON Restrictor (json_restrictor) Restrict fields returned in JSON response, e.g., only first 3 organic results with title and snippet.

Output

The node outputs the search results in the json field of the output data. By default, this is a structured JSON object containing the parsed Google Light search results, including organic results, ads, snippets, and other relevant metadata depending on the query and parameters.

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

No binary data output is produced by this node.

Dependencies

  • Requires an active SerpApi account and an API key credential configured in n8n.
  • The node sends HTTP requests to https://serpapi.com/search.json with appropriate query parameters.
  • No additional external dependencies are required beyond the API key.

Troubleshooting

  • Invalid API Key or Authentication Errors: Ensure your SerpApi API key credential is correctly configured and has sufficient quota.
  • Empty or Unexpected Results: Check if the search query and parameters are valid and supported by SerpApi. Some parameters like uule and location cannot be used together.
  • Rate Limits or Quota Exceeded: SerpApi enforces usage limits; monitor your account usage.
  • Conflicting Parameters: Avoid using mutually exclusive parameters such as no_cache and async together.
  • Incorrect Parameter Values: Use valid country codes, language codes, and domains as per SerpApi documentation.
  • Async Mode Usage: When using async mode, results must be retrieved later via the Search Archive API; ensure you handle this accordingly.

Links and References

Discussion