vøiddo guidesAll Actors on Apify

DuckDuckGo Search Scraper: how to get the data as JSON/CSV (API, Python, no code)

Scrape DuckDuckGo web search results into structured rows: title, URL, snippet, position, and query. This guide shows the output fields, a working input, and Python, JavaScript and cURL code for the Actor v0iddo/duckduckgo-scraper on Apify.

Open DuckDuckGo Search Scraper on Apify

What data you get

One row per result. Every row can be downloaded as JSON, CSV, Excel or HTML, or read through the API.

FieldLabelTypeExample
queryQuerytextweb scraping tools
positionPositionnumber1
titleTitletextThe 12 best web scraping tools for 2026 - Apify Blog
urlURLURLhttps://blog.apify.com/best-web-scraping-tools/
displayUrlDisplay URLtextblog.apify.com/best-web-scraping-tools/
snippetSnippettextWeb scraping platforms, APIs, and no-code or low-code scrapers. Bas...
pagePagenumber1

Input example

This is the input that is pre-filled on the Actor page. Change the values for your own run.

{
  "queries": [
    "web scraping tools",
    "python tutorial"
  ],
  "region": "us-en",
  "maxPages": 1,
  "safeSearch": "moderate",
  "maxItems": 20
}
Input fieldTypeWhat it does
queries (required)arrayOne or more search queries to run on DuckDuckGo.
regionstringDuckDuckGo region code for localized results, e.g.
maxPagesintegerHow many result pages to fetch per query (roughly 10 results each).
safeSearchstringSafe search filtering level applied to all queries.
maxItemsintegerThe run stops after this many result rows.

Output sample

Real rows from a run of the Actor. Fields that name people are left out of the sample.

[
  {
    "query": "web scraping tools",
    "position": 1,
    "page": 1,
    "title": "The 12 best web scraping tools for 2026 - Apify Blog",
    "url": "https://blog.apify.com/best-web-scraping-tools/",
    "displayUrl": "blog.apify.com/best-web-scraping-tools/",
    "snippet": "Web scraping platforms, APIs, and no-code or low-code scrapers. Based on five criteria, we list the top 12 web scraping tools for the year."
  },
  {
    "query": "web scraping tools",
    "position": 2,
    "page": 1,
    "title": "28 Best web scraping tools in 2026: Pros, cons and pricing - ScraperAPI",
    "url": "https://www.scraperapi.com/web-scraping/tools/",
    "displayUrl": "www.scraperapi.com/web-scraping/tools/",
    "snippet": "Compare the 28 best web scraping tools with features, pros, cons, and pricing, from web data infrastructure to open-source libraries."
  }
]

Code: Python, JavaScript and cURL

Get your API token in Apify Console under Settings, then Integrations. The Actor id is v0iddo/duckduckgo-scraper.

Python (apify-client)

from apify_client import ApifyClient

client = ApifyClient("YOUR_APIFY_TOKEN")

run_input = {'queries': ['web scraping tools', 'python tutorial'],
 'region': 'us-en',
 'maxPages': 1,
 'safeSearch': 'moderate',
 'maxItems': 20}

run = client.actor("v0iddo/duckduckgo-scraper").call(run_input=run_input)
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)

JavaScript (apify-client)

import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: 'YOUR_APIFY_TOKEN' });

const input = {
  "queries": [
    "web scraping tools",
    "python tutorial"
  ],
  "region": "us-en",
  "maxPages": 1,
  "safeSearch": "moderate",
  "maxItems": 20
};

const run = await client.actor('v0iddo/duckduckgo-scraper').call(input);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items);

cURL

curl -X POST "https://api.apify.com/v2/acts/v0iddo~duckduckgo-scraper/run-sync-get-dataset-items" \
  -H "Authorization: Bearer YOUR_APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"queries": ["web scraping tools", "python tutorial"], "region": "us-en", "maxPages": 1, "safeSearch": "moderate", "maxItems": 20}'

Price

$0.51 per 1,000 results. You pay per result row. There is no separate charge per run. Higher Apify plans pay less per result, down to $0.36 per 1,000. See the pricing tab for your plan. A new Apify account gets $5 of platform credit every month.

Good to know

FAQ

What data does the DuckDuckGo Search Scraper return?

Each result is one row in an Apify dataset. Fields include query, position, title, url, displayUrl, snippet, page. The table above shows every field with an example value.

How do I use the DuckDuckGo Search Scraper from Python?

Install the apify-client package, create a client with your Apify API token, call the Actor v0iddo/duckduckgo-scraper with an input like the one above, and read the rows from the run's dataset. The Python snippet above does exactly that.

Can I use it without writing code?

Yes. Open the Actor page on Apify, fill in the input form (an example is already filled in), press Start, and download the results as JSON, CSV, Excel or HTML. You can also schedule runs there.

How much does it cost?

$0.51 per 1,000 results. You pay per result row. There is no separate charge per run. Higher Apify plans pay less per result, down to $0.36 per 1,000. A new Apify account gets $5 of platform credit every month.

How do I limit the number of results?

Set the maxItems input field to the number of results you need; the run stops there, so it also caps the cost of one run. You can also set a maximum cost for a run in the run options on Apify, and the run stops when it is reached.

Can I send the results to Google Sheets, Make, Zapier or n8n?

Yes. Apify datasets connect to Google Sheets, Slack, Make, Zapier and n8n, and a webhook can call your own service when a run finishes. You can also export the dataset as JSON, CSV or Excel.

Open DuckDuckGo Search Scraper on Apify

Related guides