SerpApi Official icon

SerpApi Official

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

Actions72

Overview

The node provides an interface to perform live Bing web searches using the SerpApi service. It allows users to send search queries with various parameters such as location, market, country, result count, and filtering options, and receive structured search results in JSON or raw HTML format.

This node is beneficial for automating data retrieval from Bing search results without dealing with direct HTTP requests or parsing HTML manually. Practical examples include:

  • Gathering competitive intelligence by searching for specific keywords.
  • Monitoring brand mentions or news articles.
  • Extracting organic search results for SEO analysis.
  • Localized searches by specifying geographic parameters.

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 originates. 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) The market locale for the search results, e.g., en-US for English United States. 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 organic results. For example, first=10 will make the 10th organic result appear first. Defaults to 1.
Number of Results (count) Number of results per page to return. Minimum 1, maximum 50. This is a suggestion and may not reflect actual returned results.
Adult Content Filtering Level of filtering for adult content. Options: Off, Moderate (default), Strict.
Additional Filtering Complex filter options such as date ranges. Can be constructed by copying Bing's filters query parameter.
Device Device type to simulate for the search results. Options: desktop (default), tablet, mobile.
Disable Caching (no_cache) Whether to force fetching fresh results instead of cached ones. Cached results expire after 1 hour. Default false (allow cache). Cannot be used together with async.
Async Whether to perform the search asynchronously. If true, the search is submitted and results must be retrieved later via Search Archive API. Default false. Cannot be used with no_cache or on accounts with Ludicrous Speed enabled.
ZeroTrace Mode Enterprise-only option to disable storing search parameters and metadata on SerpApi servers for privacy. Default false.
Output Format of the output. Options: json (default) for structured JSON results, html for raw HTML response.
JSON Restrictor Restricts fields in the JSON 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 Bing search results structured according to SerpApi's response format. This typically includes organic search results, ads, related searches, and other metadata depending on the query and parameters.

If the output property is set to html, the node returns the raw HTML content retrieved from Bing instead of structured JSON.

No binary data output is involved.

Dependencies

  • Requires an active SerpApi account with a valid API key credential configured in n8n.
  • Internet access to reach 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 both async and no_cache to true simultaneously is disallowed.
    • Exceeding rate limits or quota on SerpApi account can cause request failures.
    • Incorrectly formatted filter strings may result in empty or error responses.

  • Error messages:

    • Authentication errors indicate invalid or missing API credentials; verify and update the API key.
    • Parameter validation errors suggest incompatible or malformed input parameters; review property values.
    • Network or timeout errors may require checking internet connectivity or retrying later.

Links and References

Discussion