SerpApi Official icon

SerpApi Official

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

Overview

This node integrates with SerpApi's official API to perform live Google Video searches. It allows users to query Google Videos programmatically and retrieve structured search results. This is useful for scenarios such as content discovery, market research, competitive analysis, or automating video data collection from Google.

For example, a marketing team could use this node to automatically gather trending videos related to a product or topic, or a developer might build an app that fetches video search results dynamically based on user input.

Properties

Name Meaning
Search Query (q) The search term or phrase you want to look up in Google Videos. (Required)
Location (location) Geographic location from which the search should originate. See SerpApi locations API for supported values.
Encoded Location (uule) Google encoded location string for search origin. Cannot be used together with location.
Domain (google_domain) Google domain to use for the search, e.g., google.com, google.co.uk, google.fr, etc. A long list of country-specific Google domains is available.
Country (gl) Country code to use for the search, e.g., us, gb, fr, de, etc. Controls regional search results.
Language (hl) Language code for the search interface and results, e.g., en, fr, es, de, etc.
Set Multiple Languages (lr) Limit search results to one or more languages using language codes separated by `
as_dt Include or exclude results from the site specified in as_sitesearch.
as_epq Phrase that all documents in the results must contain.
as_eq Word or phrase that should not appear in any document in the results.
as_lq All results should contain a link to this URL.
as_nlo Start value for a numeric search range.
as_nhi End value for a numeric search range.
as_oq Additional search terms where each result must contain at least one.
as_q Additional search terms to check for in documents.
as_qdr Time period filter for results (quick date range).
as_rq Results should be pages related to this URL.
as_sitesearch Restrict results to pages from this site.
Advanced Search Parameters (tbs) Advanced search parameters not possible in regular query, e.g., patents, dates, news, videos, images, apps, or text contents.
Adult Content Filtering (safe) Level of filtering for adult content: Active or Off.
Exclude Auto-corrected Results (nfpr) Exclude results from auto-corrected queries when original query is misspelled.
Results Filtering (filter) Enable or disable filters for "Similar Results" and "Omitted Results".
Result Offset (start) Number of results to skip (offset).
Number of Results (num) Maximum number of results to return.
Device (device) Device type for search results: desktop, tablet, or mobile.
Disable Caching (no_cache) Force fetching new results instead of cached ones. Cached results are free and expire after 1 hour.
Async (async) Perform search asynchronously. If true, results must be retrieved later via Search Archive API. Not compatible with no_cache or certain account types.
ZeroTrace Mode (zero_trace) Enterprise-only mode to avoid storing search parameters and metadata on SerpApi servers for privacy.
Output (output) Format of final 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 a JSON object containing the full structured results from the Google Videos search via SerpApi. This includes metadata about the search, video results, and other relevant information as provided by the API.

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

No binary data output is indicated.

Dependencies

  • Requires an active SerpApi account and an API key credential configured in n8n.
  • The node makes HTTP requests to https://serpapi.com/search.json with appropriate query parameters.
  • Proper API authentication must be set up in n8n credentials for SerpApi.

Troubleshooting

  • Missing or invalid API key: Ensure your SerpApi API key credential is correctly configured and valid.
  • Invalid or missing required parameters: The Search Query (q) parameter is mandatory; ensure it is provided.
  • Conflicting parameters: Do not use both location and uule simultaneously as they conflict.
  • Async and no_cache conflict: These two options cannot be enabled together.
  • Rate limits or quota exceeded: SerpApi may limit requests; monitor usage and upgrade plan if needed.
  • Unsupported location or language codes: Use only supported values as per SerpApi documentation.
  • Empty or unexpected results: Check query syntax and parameters; try simpler queries to debug.

Links and References

Discussion