SerpApi Official icon

SerpApi Official

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

Actions72

Overview

The node performs live web searches using the Bing Search engine via SerpApi's official API. It allows users to send search queries with various parameters to retrieve real-time search results from Bing, including organic results, images, news, and more.

This node is beneficial in scenarios where automated or programmatic access to Bing search results is needed, such as:

  • Market research by extracting search trends or competitor information.
  • Content aggregation by fetching relevant articles or data based on keywords.
  • SEO analysis by monitoring search result rankings.
  • Building custom search tools or bots that require Bing search data.

For example, a user can input a query like "Coffee shops near me" with location parameters to get localized search results for coffee shops.

Properties

Name Meaning
Search Query (q) The main search query string. Supports typical Bing search syntax including operators like NOT, OR, site:, filetype:, near:, ip:, loc:, feed:, etc. Example: "Coffee".
Location (location) Defines the geographic location from which the search should originate. Refer to SerpApi's locations API for supported values.
Latitude (lat) GPS latitude coordinate to specify the exact origin of the search.
Longitude (lon) GPS longitude coordinate to specify the exact origin of the search.
Market codes (mkt) Specifies the market locale for the search results, e.g., "en-US" for English - United States. This parameter is mutually exclusive with the country code parameter.
Country (cc) Two-letter ISO 3166-1 country code defining the country context for the search, e.g., "US" for United States, "DE" for Germany.
Result Offset (first) Controls the offset of the organic results. For example, setting this to 10 will make the 10th organic result appear first. Defaults to 1.
Number of Results (count) Number of results per page to return. Minimum is 1, maximum is 50. Note that this is a suggestion and actual results may vary.
Adult Content Filtering (safeSearch) Level of filtering for adult content in the search results. Options are Off, Moderate (default), and Strict.
Additional Filtering (filters) Allows complex filtering options such as date ranges by specifying filter query parameters copied from Bing search URLs.
Device (device) Defines the device type for the search results: desktop (default), tablet, or mobile.
Disable Caching (no_cache) If true, forces fetching fresh results instead of cached ones. Cached results expire after 1 hour. Cannot be used together with async mode. Default is false.
Async (async) If true, submits the search asynchronously and requires retrieving results later via a separate API. Cannot be used with no_cache and not recommended for accounts with Ludicrous Speed enabled. Default is false.
ZeroTrace Mode (zero_trace) Enterprise-only option to disable storing search parameters, files, and metadata on SerpApi servers for privacy. May complicate debugging. Default is false.
Output (output) Defines the output format: "json" (default) returns structured JSON results; "html" returns raw HTML of the search page.
JSON Restrictor (json_restrictor) Restricts the JSON response fields to specific parts, e.g., "organic_results[0:3].{title,snippet}" returns only title and snippet of the first 3 organic results.

Output

The node outputs a JSON object containing the search results returned by SerpApi's Bing Search API. The structure includes various fields such as organic search results, ads, related searches, and other metadata depending on the query and parameters.

If the output format is set to "html", the node returns the raw HTML content of the Bing search results page.

No binary data output is produced by this node.

Dependencies

  • Requires an active SerpApi account with a valid API key credential configured in n8n.
  • Internet access to call SerpApi's endpoint at https://serpapi.com/search.json.
  • Proper configuration of the API key credential in n8n to authenticate requests.

Troubleshooting

  • Common Issues:

    • Invalid or missing API key credential will cause authentication errors.
    • Using mutually exclusive parameters together (e.g., both market code and country code) may lead to unexpected results or errors.
    • Setting incompatible options like no_cache and async simultaneously will cause request failures.
    • Exceeding rate limits or quota on SerpApi account will result in error responses.

  • Error Messages:

    • Authentication errors typically indicate invalid or missing API credentials.
    • Parameter validation errors occur if required fields like the search query are empty or malformed.
    • Network errors may happen due to connectivity issues or incorrect base URL configuration.

  • Resolutions:

    • Ensure the API key credential is correctly set up and active.
    • Review parameter combinations and avoid conflicting options.
    • Check network connectivity and SerpApi service status.
    • Consult SerpApi documentation for correct usage of advanced filters and parameters.

Links and References

Discussion