DuckDuckGo Node icon

DuckDuckGo Node

DuckDuckGo Search
Join our community

Actions4

Overview

This node performs searches using the DuckDuckGo search engine. It supports multiple types of searches including general web search, image search, news search, and video search. The node is useful for automating retrieval of search results directly within workflows, enabling users to gather relevant information, images, news articles, or videos based on a query.

For the Search Videos operation specifically, the node fetches video search results matching the provided query. This can be beneficial in scenarios such as content curation, media monitoring, or building applications that require video metadata from DuckDuckGo without manual browsing.

Example use cases:

  • Automatically retrieving recent videos related to a topic for social media analysis.
  • Gathering video metadata like duration, publisher, and view count for content aggregation.
  • Integrating video search results into dashboards or reports.

Properties

Name Meaning
Query The search term or phrase to look up videos for.
Locale The locale/language code to tailor search results (e.g., "en-us" for English - United States).
Safe Search Level of safe search filtering:
- Strict (0): Filters out adult content strictly.
- Moderate (-1): Moderate filtering.
- Off (-2): No filtering, all content included.

Output

The output is an array of JSON objects, each representing a single video search result with the following fields:

  • description: Text description of the video.
  • duration: Length of the video (likely in seconds).
  • image: URL to a thumbnail or representative image of the video.
  • published: Timestamp or date string indicating when the video was published.
  • publishedOn: Additional publication info (possibly formatted date or source).
  • publisher: Name or identifier of the video's publisher.
  • title: Title of the video.
  • url: Direct URL to the video.
  • viewCount: Number of views the video has received.

Each item is paired with the input item index it corresponds to, allowing traceability in batch operations.

The node does not output binary data.

Dependencies

  • Uses the external duck-duck-scrape library to perform DuckDuckGo scraping-based searches.
  • Requires internet access to connect to DuckDuckGo services.
  • No API keys or authentication tokens are needed since DuckDuckGo is a public search engine.

Troubleshooting

  • Common issues:

    • Network connectivity problems may cause the node to fail fetching results.
    • Changes in DuckDuckGo's page structure could break the scraping logic, resulting in empty or malformed outputs.
    • Providing an empty or invalid query will return no results.

  • Error messages:

    • Errors thrown by the underlying scraping library will be surfaced. If the node is set to continue on failure, errors will be attached to the output item.
    • Typical errors include request timeouts or unexpected response formats.

  • Resolutions:

    • Ensure stable internet connection.
    • Verify the query string is valid and non-empty.
    • Update the node or dependencies if DuckDuckGo changes affect scraping.
    • Use the "Continue On Fail" option to handle intermittent failures gracefully.

Links and References

Discussion