SerpApi Official icon

SerpApi Official

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

Actions72

Overview

This node enables users to perform live Google Video searches using SerpApi's official API. It is designed to fetch video search results from Google based on a user-defined query and various optional parameters that refine the search context, such as location, language, device type, and filtering options.

Typical use cases include:

  • Retrieving video content related to specific topics or keywords for content curation.
  • Automating video search data collection for market research or SEO analysis.
  • Integrating Google Video search results into workflows or applications without manual searching.

For example, a marketing team could automate fetching trending videos about a product category in a specific country and language to analyze competitor content.

Properties

Name Meaning
Search Query (q) The main search term or phrase to find relevant Google Videos. This is 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 precise location targeting. 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. Defaults to google.com.
Country (gl) Country code to influence search results geographically, e.g., us for United States, gb for United Kingdom. Defaults to us.
Language (hl) Language code to specify the language of the search interface and results, e.g., en for English, fr for French. Defaults to en.
Set Multiple Languages (lr) Limit search results to one or more languages using language codes separated by `
as_dt Controls inclusion or exclusion of results from the site specified in as_sitesearch.
as_epq Phrase that all documents in the search results must contain.
as_eq Word or phrase that should not appear in any documents in the search results.
as_lq All search results should contain a link to this URL.
as_nlo Starting value for a numeric search range (inclusive).
as_nhi Ending value for a numeric search range (inclusive).
as_oq Additional search terms where each document must contain at least one.
as_q Additional search terms to check for in documents.
as_qdr Requests search results from a specified time period (quick date range). See SerpApi docs for details.
as_rq All search results should be pages related to this URL.
as_sitesearch Restrict search results to pages from this site. Can be combined with as_dt to exclude pages.
Advanced Search Parameters (tbs) Advanced search parameters for specialized queries like patents, dates, news, videos, images, apps, or text contents.
Adult Content Filtering (safe) Level of filtering for adult content: active (default) or off.
Exclude Auto-corrected Results (nfpr) Whether to exclude results from auto-corrected queries when the original query is misspelled. Boolean.
Results Filtering (filter) Whether filters for 'Similar Results' and 'Omitted Results' are enabled (true by default) or disabled.
Result Offset (start) Number of results to skip before starting to return results. Default is "0".
Number of Results (num) Maximum number of results to return.
Device (device) Device type to simulate for the search: desktop (default), tablet, or mobile.
Disable Caching (no_cache) Force fetching new results instead of cached ones. Boolean. Cache expires after 1 hour. Default is false. Should not be used with async.
Async (async) Perform search asynchronously. If true, search is submitted and results retrieved later via Search Archive API. Default is false. Should not be used with no_cache or accounts with Ludicrous Speed enabled.
ZeroTrace Mode (zero_trace) Enterprise-only mode to avoid storing search parameters and metadata on SerpApi servers. Boolean, default false.
Output (output) Format of the final output: json (default) for structured JSON or html for raw HTML.
JSON Restrictor (json_restrictor) Limits fields returned in the response, e.g., organic_results[0:3].{title,snippet} returns only title and snippet of first 3 organic results.

Output

The node outputs a JSON object containing the Google Video search results as returned by SerpApi. The structure typically includes:

  • search_metadata: Metadata about the search request.
  • search_parameters: Parameters used for the search.
  • video_results: An array of video result objects, each containing details such as:
    • title: Title of the video.
    • link: URL to the video.
    • thumbnail: Thumbnail image URL.
    • source: Source website or channel.
    • duration: Length of the video.
    • Other metadata depending on the API response.

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

The node does not output binary data.

Dependencies

  • Requires an active SerpApi account and a valid API key credential configured in n8n.
  • Internet access to call SerpApi endpoints.
  • No additional external dependencies beyond the SerpApi service.

Troubleshooting

  • Missing or invalid API key: The node requires a valid API key credential. Ensure the API key is correctly configured and has sufficient quota.
  • Invalid or missing required parameters: The Search Query (q) parameter is mandatory. Omitting it will cause errors.
  • Conflicting parameters: Using both location and uule simultaneously will cause the request to fail; use only one.
  • Async and no_cache conflict: Setting both async and no_cache to true is not allowed.
  • Rate limits or quota exceeded: SerpApi enforces usage limits; exceeding them will result in errors.
  • Unsupported location or language codes: Use only supported values as per SerpApi documentation.
  • Network issues: Ensure the node can reach https://serpapi.com.

Common error messages usually indicate missing credentials, invalid parameters, or quota issues. Review the error message details and adjust parameters or credentials accordingly.

Links and References

Discussion