DuckDuckGo Node icon

DuckDuckGo Node

DuckDuckGo Search
Join our community

Actions4

Overview

This node performs searches using the DuckDuckGo search engine, supporting multiple types of queries including general web search, image search, news search, and video search. It is useful for automating data retrieval from DuckDuckGo without needing direct API access, enabling workflows that require fetching fresh search results programmatically.

For the Search News operation specifically, the node fetches recent news articles matching a given query, returning details such as title, excerpt, publication date, and related metadata. This can be beneficial for monitoring news trends, gathering information on specific topics, or integrating news content into other applications.

Example use cases:

  • Automatically retrieving latest news headlines about a company or event.
  • Aggregating news snippets for sentiment analysis or reporting.
  • Enriching datasets with current news context relevant to certain keywords.

Properties

Name Meaning
Query The search term or phrase to look up in DuckDuckGo News.
Locale The locale/language code to tailor search results (e.g., "en-us" for English - United States).
Safe Search Level of safe search filtering applied to results. Options: Strict, Moderate, Off.

Output

The output is an array of JSON objects, each representing a news article found by the search. Each object contains:

  • date: The publication date as a JavaScript Date object (or null if unavailable).
  • excerpt: A short summary or snippet from the news article.
  • image: URL of an associated image if available.
  • isOld: Boolean indicating if the news item is considered old.
  • relativeTime: Human-readable relative time since publication (e.g., "2 hours ago").
  • syndicate: Syndication source information if present.
  • title: Title of the news article.
  • url: Direct URL to the full news article.

The node does not output binary data.

Dependencies

  • Uses the external duck-duck-scrape library to perform DuckDuckGo scraping-based searches.
  • No API keys or authentication tokens are required.
  • Requires internet access to reach DuckDuckGo services.

Troubleshooting

  • Empty results: If no news articles are returned, verify the query string is valid and that the locale is appropriate for the desired content.
  • Network errors: Ensure the node has internet connectivity; DuckDuckGo scraping depends on live HTTP requests.
  • Rate limiting or blocking: Excessive automated requests might trigger anti-bot measures from DuckDuckGo, causing failures.
  • Date parsing issues: Some news items may lack valid timestamps, resulting in null dates.
  • Safe Search setting: Setting Safe Search to "Off" may return inappropriate content; adjust according to your needs.

If errors occur during execution, the node either continues processing remaining items (if configured to continue on failure) or throws an error indicating the item index and cause.

Links and References

Discussion