SerpApi Official icon

SerpApi Official

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

Actions37

Search → DuckDuckGo Search

AI-generated

Overview

This node performs a DuckDuckGo search using the SerpApi service. It allows users to input a search query and customize the search with various optional parameters such as region, adult content filtering, date filtering, pagination offset, caching behavior, asynchronous search, output format, and JSON response restrictions. This node is useful for retrieving live search results from DuckDuckGo in a structured JSON format or raw HTML, which can be used for data analysis, content aggregation, or automation workflows.

Use Case Examples

  1. A marketing analyst uses this node to gather search results for competitor analysis by querying specific keywords and filtering results by region and date.
  2. A developer integrates this node into a workflow to fetch the latest news articles related to a topic by setting the search query and restricting the JSON response to relevant fields.
  3. A content creator uses the node to retrieve safe search results for family-friendly content by enabling strict adult content filtering.

Properties

Name Meaning
Search Query (q) Defines the query you want to search on DuckDuckGo. This is a required string input.
Region (kl) Defines the region to use for the DuckDuckGo search, affecting localized search results. It is an optional field with multiple predefined region options such as 'us-en' for United States English, 'fr-fr' for France French, etc.
Adult Content Filtering (safe) Defines the level of filtering for adult content in the search results. Options include Strict, Moderate, and Off.
Filter By Date (df) Filters search results by date. This is a string parameter to specify date filtering criteria.
Result Offset (start) Defines the result offset for pagination, skipping the given number of results.
Disable Caching (no_cache) Forces fetching new results even if a cached version is present. Cache expires after 1 hour. Default is false to allow cached results.
Async (async) Determines whether to perform the search asynchronously. If true, the search is submitted and results are retrieved later via Search Archive API. Default is false.
ZeroTrace Mode (zero_trace) Enterprise-only option to skip storing search parameters, files, and metadata on SerpApi servers for privacy. Default is false.
Output (output) Defines the final output format. Can be 'json' for structured JSON results or 'html' for raw HTML.
JSON Restrictor (json_restrictor) Restricts fields in the JSON response to specified fields and ranges, e.g., organic_results[0:3].{title,snippet}.

Output

JSON

  • search_metadata - Metadata about the search request and response.
  • search_parameters - Parameters used in the search query.
  • search_information - Information about the search results such as total results and time taken.
  • organic_results - List of organic search results returned by DuckDuckGo.
  • ads_results - List of advertisement results if any.
  • related_searches - List of related search queries suggested by DuckDuckGo.
  • pagination - Pagination details for the search results.

Dependencies

  • SerpApi API key credential

Troubleshooting

  • Ensure the SerpApi API key credential is correctly configured and valid.
  • Check network connectivity and that the SerpApi service endpoint is reachable.
  • Verify that required parameters like the search query (q) are provided and correctly formatted.
  • If using asynchronous search, ensure to handle retrieval of results from the Search Archive API as needed.
  • Be aware of rate limits and usage quotas imposed by SerpApi to avoid request failures.

Links

Discussion