duckduckgo-search-api

Search DuckDuckGo and return organic results with titles, links, and snippets. Apify-backed n8n community node, pay-per-result, and usable as an AI agent tool.

Package Information

Released: 4 mo ago
Downloads: 13 weekly / 281 monthly
Latest Version: 0.1.1
Author: John Cole

Available Nodes

DuckDuckGo Search icon
DuckDuckGo Search
Search DuckDuckGo and return organic results with titles, links, and snippets

Documentation

n8n-nodes-duckduckgo-search-api

An n8n community node that searches DuckDuckGo and returns structured organic results: position, title, link, snippet, and date. It is backed by the DuckDuckGo Search API on Apify and bills per result, so there are no subscriptions and no minimums.

Installation · Credentials · Operations · Output · Example workflows · Pricing · Resources

What it does

Give the node a query, and it returns one item per organic result with the position, title, link, snippet, and date. It also works as an AI Agent tool, so an agent can run privacy-friendly web searches on demand.

  • Search DuckDuckGo and get clean organic results
  • Localize with a region and language code, and set safe search
  • Restrict results by recency and fetch multiple pages
  • Choose how much data to return per result: Simplified, Raw, or Selected Fields

Installation

Follow the n8n community nodes installation guide:

  1. In n8n, open Settings > Community Nodes.
  2. Select Install.
  3. Enter n8n-nodes-duckduckgo-search-api as the npm package name.
  4. Agree to the risks of using community nodes, then select Install.

After it installs, the DuckDuckGo Search node appears in the nodes panel.

n8n Cloud only allows verified community nodes. Until this node is verified, install it on a self-hosted n8n instance.

Credentials

You need a free Apify account and an API token.

  1. Sign in to the Apify Console.
  2. Open Settings > Integrations and copy your Personal API token.
  3. In n8n, create a new Apify API credential and paste the token.
  4. Use the credential's Test button to confirm it works.

The node also supports Apify OAuth2 if you prefer to connect that way.

Operations

Search Result > Search returns organic results for a query.

Parameter Description
Search Query The query to search for. Required.
Localization Region and language code, for example us-en.
Safe Search Moderate, Off, or Strict.
Date Filter Restrict by recency: d, w, m, or y. Optional.
Maximum Pages How many result pages to fetch.
Output How much data to return: Simplified, Raw, or Selected Fields.

Output

Each organic result is returned as its own n8n item. The Output parameter lets you choose how much to return:

  • Simplified (default): a compact object with position, title, link, snippet, and date. This mode is also used automatically when the node runs as an AI Agent tool, to keep responses small.
  • Raw: every field the API returns for each result, using the original field names below.
  • Selected Fields: pick exactly which fields to include.

Fields (Raw and Selected Fields)

Field Type Description
position integer Rank of the result on the page
title string Result title
link string Result URL
snippet string Result snippet text
date string Result date, when available
date_raw string Raw date string from the source
favicon string Favicon URL for the result domain

Example workflows

1. Track DuckDuckGo rankings for a keyword

  1. Schedule Trigger: run daily.
  2. DuckDuckGo Search: Search Query your keyword, Output Simplified.
  3. Filter: keep the item whose link matches your domain; log its position over time.

2. Collect results into a sheet

  1. Manual Trigger.
  2. DuckDuckGo Search: your query, Maximum Pages 3.
  3. Google Sheets: append each result's position, title, and link.

3. Let an AI Agent search the web

  1. AI Agent node.
  2. Attach DuckDuckGo Search as a tool.
  3. Ask the agent a question; it calls the node (in Simplified mode) and answers using live results.

Pricing

This node calls the DuckDuckGo Search API on Apify, which is billed pay-per-result, with no subscription and no minimums. Apify also includes a free monthly usage tier that covers typical volumes. See the Actor page for current rates.

Resources

License

MIT

Discussion