DuckDuckGo Block

The DuckDuckGo block integrates DuckDuckGo search into your workflows so you can perform web searches, fetch news results, and find images without tracking. Reach for it when a step needs fresh, privacy-respecting search data and you don't want to manage an API key.

Overview

When to Use

• Pull live web results to feed an agent or downstream block with up-to-date context.
• Search recent news on a topic to summarize or trigger follow-up actions.
• Find images related to a query for enrichment or display.
• Add web lookups to a workflow without provisioning a search API credential.
• Localize results to a specific region using a DuckDuckGo region code.
• Retrieve instant answers, abstracts, and related topics for knowledge-enrichment steps.

Configuration

Operation

Required dropdown that selects which type of search to run. The chosen operation determines which tool is invoked and which outputs are populated.

Search Query

Required free-text field. Enter the search terms to pass to DuckDuckGo. Supports {{blockName.field}} references to inject upstream values at runtime.

Max Results

Optional dropdown capping the number of results returned. Available options: 5, 10, 20, 50. Applies to News Search and Image Search operations; Web Search returns whatever the Instant Answers API provides.

Region

Optional short-text field. A DuckDuckGo region code that localizes results (for example, wt-wt for worldwide, us-en for United States English). Leave blank for the default worldwide results.

Inputs & Outputs

Inputs:

• operation (string) — Operation to perform; one of duckduckgo_text_search, duckduckgo_news_search, or duckduckgo_images_search.
• query (string) — Search query to execute.
• maxResults (string) — Maximum number of results to return.
• region (string) — Search region code (e.g., wt-wt, us-en).

Outputs (the block exposes all three slots; only the slot matching the selected operation is populated per run):

• results (json) — Search results for Web Search or Image Search operations.
• news (json) — News results for News Search operations.
• images (json) — Image results for Image Search operations.

Tools

DuckDuckGo Text Search (duckduckgo_text_search) — Queries the DuckDuckGo Instant Answers API. Returns a structured response containing a heading, abstract, abstractText, abstractSource, abstractURL, image URL, direct answer (if available), response type (A article / D disambiguation / C category), an array of relatedTopics, and an array of external-link results. No API key required.

DuckDuckGo News Search (duckduckgo_news_search) — Searches DuckDuckGo for recent news articles. Returns a results array where each item contains title, url, source, date, and excerpt. Supports maxResults and region params.

DuckDuckGo Images Search (duckduckgo_images_search) — Searches DuckDuckGo for images. Returns a results array where each item contains title, url, thumbnail, source, width, and height. Supports maxResults and region params.

YAML Example

duckduckgo_1:
  type: duckduckgo
  name: "DuckDuckGo"
  inputs:
    operation: "duckduckgo_news_search"
    query: "{{trigger.topic}}"
    maxResults: "10"
    region: "us-en"
  connections:
    outgoing:
      - target: next-block-id