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 SerpApi's official API. It is designed to fetch structured search results from Google, supporting a wide range of search types including web, images, news, videos, shopping, local business listings, and more.

Common scenarios where this node is beneficial include:

Automating data collection for SEO or market research by retrieving Google search results programmatically.
Extracting localized search results by specifying location and language parameters.
Gathering specific types of content 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 analyst can use this node to query "Coffee shops near New York" with the location set to New York and retrieve local business listings.
An e-commerce platform can automate product price comparison by searching Google Shopping results for specific products.

Properties

Name	Meaning
Search Query (q)	The main search query string you want to search for. Example: "Coffee".
Location (location)	Defines 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): Select Google domain to use (e.g., google.com, google.co.uk, etc.) - Country (gl): Country code for search - Language (hl): Language code for search - Set Multiple Countries (cr) - Set Multiple Languages (lr) - 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 (device): desktop, tablet, mobile - Disable Caching (no_cache) - Async (async) - ZeroTrace Mode (zero_trace) - Output (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 used but typically includes fields such as organic search results, ads, knowledge graph data, local pack results, images, videos, and more.

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

Binary data output is not indicated in the provided properties or source code.

Dependencies

Requires an API key credential for SerpApi to authenticate requests.
The node makes HTTP requests to https://serpapi.com/search.json endpoint.
No other external dependencies are indicated.

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.
Async Mode Usage: When using async mode, results must be retrieved later via the Search Archive API; immediate results will not be available.
Unsupported Locations or Languages: Use only supported location and language codes as per SerpApi documentation.
ZeroTrace Mode: Enabling ZeroTrace disables storing search metadata, which may complicate debugging.