SerpApi Official icon

SerpApi Official

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

Actions72

Overview

This node integrates with SerpApi's official API to perform live Google Search queries and retrieve structured search results. It is designed to fetch various types of Google search data, including web search results, images, news, videos, shopping, local business listings, and more.

Common scenarios where this node is beneficial include:

  • Automating the retrieval of Google search results for SEO analysis or market research.
  • Extracting localized search results by specifying location or language parameters.
  • Gathering specific types of search data such as images, news articles, or product listings.
  • Integrating Google search capabilities into workflows without dealing with scraping or parsing HTML manually.

Practical example:

  • A marketing team can use this node to automatically collect the top 10 organic search results for a given keyword in a specific country and language, enabling them to monitor competitor content.
  • An e-commerce platform could use it to pull Google Shopping results for price comparison or product availability checks.

Properties

Name Meaning
Search Query (q) The main 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 advanced parameters to customize the search, including:
- Encoded Location (uule)
- Google Place ID (ludocid)
- Additional Google Place ID (lsig)
- Google Knowledge Graph ID (kgmid)
- Cached Search Parameters ID (si)
- Element Rendering (ibp)
- Filter Search (uds)
- Domain (google_domain): Google domain to use (e.g., google.com, google.co.uk)
- Country (gl): Country code for search
- Language (hl): Language code for search
- Set Multiple Countries (cr): Limit search to multiple countries
- Set Multiple Languages (lr): Limit search to multiple languages
- Include/Exclude Site (as_dt)
- Required Phrase (as_epq)
- Excluded Word/Phrase (as_eq)
- Link to URL (as_lq)
- Search Range Start (as_nlo)
- Search Range End (as_nhi)
- Additional Search Terms (as_oq)
- Search Terms (as_q)
- Time Period (as_qdr)
- Related URL (as_rq)
- Site Search (as_sitesearch)
- Advanced Search Parameters (tbs)
- Adult Content Filtering (safe): active or off
- Exclude Auto-corrected Results (nfpr)
- Results Filtering (filter)
- Search Type (tbm): e.g., images, local, news, patents, shopping, videos
- Result Offset (start)
- Number of Results (num)
- Device: desktop, tablet, mobile
- Disable Caching (no_cache)
- Async (async)
- ZeroTrace Mode (zero_trace)
- Output format (output): json or html
- JSON Restrictor (json_restrictor)

Output

The node outputs a JSON object containing the structured search results returned by SerpApi. The exact structure depends on the search type and parameters but generally includes fields such as organic search results, ads, knowledge graph data, images, videos, and other relevant metadata.

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

Binary data output is not indicated for this operation.

Dependencies

  • Requires an API key credential for SerpApi to authenticate requests.
  • The node sends HTTP requests to https://serpapi.com/search.json.
  • No additional environment variables are required beyond the API key credential.

Troubleshooting

  • Invalid API Key or Authentication Errors: Ensure that a valid SerpApi API key is configured in the node credentials.
  • Empty or Unexpected Results: Verify that the search query (q) and other parameters are correctly set. Some parameters like uule and location cannot be used together.
  • Rate Limits or Quotas: SerpApi enforces usage limits; exceeding these may cause errors or blocked requests.
  • Conflicting Parameters: Parameters no_cache and async should not be used together.
  • Unsupported Locations or Languages: Use only supported location and language codes as per SerpApi documentation.
  • Async Mode Usage: When using async mode, results must be retrieved later via the Search Archive API; ensure correct workflow for this.

Links and References

Discussion