# DuckDuckGo Scraper API: Search Results as JSON | Scrapier (https://scrapier.io/scrapers/duckduckgo/)

> DuckDuckGo scraper API: web, image, video and news results for any keyword and region as typed JSON. 1 credit per successful call. Get a free API key.

Last updated: 2026-11-12

## DuckDuckGo Scraper API: _1 endpoint_, structured JSON

DuckDuckGo web results for any keyword and region, with title, URL, hostname, description and position, plus image, video and news modes, as typed JSON. Public data only.

[Get a free API key →](https://app.scrapier.io/sign-up)

Copy for your AI agent

**1**DuckDuckGo endpoint

**1**credit per successful call

**0**credits for a failed call

**1**need no DuckDuckGo login

Quick answerScrapier returns typed JSON from **1 DuckDuckGo endpoint**: web, image, video and news search results. Public data only and no proxies; no DuckDuckGo login needed. 1 credit per successful call; failed calls are free. Last verified 9 Nov 2026

Endpoints

## What data can I extract with DuckDuckGo Scraper?

One endpoint covers DuckDuckGo search: send a keyword, pick a mode and a region, and get clean JSON back for 1 credit per successful call.

[### SearchStart here

`**GET**/api/v2/duckduckgo-search/`

Results for one keyword: title, URL, hostname, description and position. Web by default; images, videos or news on request.

1 credit per call_View →Page soon_](https://scrapier.io/scrapers/duckduckgo/search/)

Playground

## Try DuckDuckGo Scraper Live

Pick an endpoint, fill in the input and press **Run**. Without a key you see the catalog sample and nothing is billed. With your API key it runs a real call from your browser.

DuckDuckGo**Search**Live

Platform

Endpoint

Parameters

### \+ Run live with your API key

Response

Sample dataCatalog sample, run to see live data

Pricing

## How much will scraping DuckDuckGo cost?

Every successful call costs 1 credit, whether the page holds one profile or a page of comments. Failed calls cost nothing. A free tier lets you try it first.

On Pro, 1,000 calls at 1 credit cost $1.58. Scale brings that to $1.20, so 250,000 DuckDuckGo calls a month is $299.

[See all plans →](https://scrapier.io/pricing/)

| Plan | Price / mo | Credits / mo | Per 1,000 calls |
| --- | --- | --- | --- |
| Free | $0 | Free tier | — |
| Hobby | $29 | 15,000 | $1.93 |
| Pro | $79 | 50,000 | $1.58 |
| Scale | $299 | 250,000 | $1.20 |

How to

## How do I use DuckDuckGo Scraper?

Built to be easy to start with, even if you've never scraped a website. Here's how to get DuckDuckGo search results in a few minutes:

[Get a free API key →](https://app.scrapier.io/sign-up)

1. **Create a free Scrapier account**[Sign up](https://app.scrapier.io/sign-up) with your email and copy your API key.
2. **Add your keyword**One search term per call in `query`.
3. **Pick a mode**`search_mode`: `default` for web, or `images`, `videos` or `news`.
4. **Pick a region and safe search**`region` takes a code such as wt-wt, us-en or uk-en; `safe_search` sets the filter level.
5. **Page through the results**Pass `next_cursor` back as `cursor` for the next page; mode, region and safe search stay locked in.
6. **Run the request**One GET with your key in the `X-API-Key` header, or ask your AI agent over MCP to call it for you.
7. **Save the results**JSON from the API: store it as is, or flatten it to CSV in a few lines.

Input

## Input

Every endpoint takes the same kind of input.

1

### By keyword

You don't know the items yet: find them with a keyword.

Search`python programming`

Best fordiscovery · plain text, "travel" not "#travel"

Example requests

// GET /api/v2/duckduckgo-search/
{
  "query": "python programming",
  "search\_mode": "default",
  "region": "wt-wt",
  "safe\_search": "OFF"
}

| Send this | Parameter | And you can get |
| --- | --- | --- |
| Keyword | `query` | Web results with title, URL, hostname and description |
| Keyword and mode | `query` · `search_mode` | Image, video or news results instead of web |
| Region and filter | `region` · `safe_search` | Results for that region and safe-search level |

Optional on list endpoints: `cursor` (pass back `next_cursor` for the next page). Auth is one header: `X-API-Key`. Send parameters in the query string (GET) or as a JSON body (POST).

Output

## Output

The one thing to know: **each data type has its own shape**. Field names stay the same on every call, so code and agents read them directly. Samples below come from the live catalog.

// GET /api/v2/duckduckgo-search/?query=python programming
// one item of data.results · catalog sample
{
  "title": "Welcome to Python.org",
  "url": "https://www.python.org/",
  "hostname": "www.python.org",
  "description": "The official home of the Python Programming Language.",
  "icon": "https://external-content.duckduckgo.com/ip3/www.python.org.ico",
  "raw\_description": "The official home of the Python Programming Language.",
  "position": 1,
  "keyword": "python tutorial"
}

Every response is `{"success": true, "data": {…}}`: your input echoed back, the result under its own key (`profile`, `posts`, `comments`…) and `next_cursor` for the next page.

Use cases

## What can you do with DuckDuckGo data?

Public DuckDuckGo data powers SEO rank tracking, privacy-focused search research and AI agents that need fresh sources. Here are three common jobs, and the DuckDuckGo scraper endpoint they use.

01

### DuckDuckGo rank tracking

Run your keyword list on DuckDuckGo per region and record where your pages rank. Compare with Google and Bing to see how a privacy-minded audience finds you.

1. _1_search
2. Rank report

WeeklySheets, BI dashboard

02

### News and media monitoring

Switch search\_mode to news, images or videos to follow coverage of a brand or topic. Collect new results on a schedule and review what changed.

1. _1_search
2. Coverage feed

DailyDashboard, CSV

03

### Fresh sources for AI agents

Let an agent search DuckDuckGo before it answers and read the pages it picks. Grounding answers in current results cuts stale or invented replies.

1. _1_search
2. Source list

On demandAI agent, vector store

Features

## Features

DuckDuckGo Scraper fetches clean, structured DuckDuckGo search data at low cost: built for SEO tools, media monitoring and AI agents.

### Live data, every call

Each request reads DuckDuckGo at call time, so you get what the results page shows now, not a stale cache.

### Typed, consistent JSON

Same field names on every call, numbers as numbers, ready for code, sheets or an LLM.

### Results, page by page

Each page returns `next_cursor`; run up to 3 requests in parallel per key.

### 1 scrapers, one shape

Web, image, video and news modes share the same endpoint, envelope and auth.

### MCP-ready for AI agents

The Scrapier MCP server reaches every live endpoint from Claude Code, Cursor, Windsurf and VS Code with one command.

### Works with your stack

Plain REST: Python, Node.js, cURL, n8n, Make, Zapier or Google Sheets.

### No proxies to manage

Public results only. No DuckDuckGo account or key; Scrapier runs the proxies.

### Maintained for you

When DuckDuckGo changes its pages, Scrapier updates the scraper; your field names stay the same.

### Pay per successful call

1 credit per call, whether the page holds one result or ten. Failed calls are never billed.

Why Scrapier

## Why choose this DuckDuckGo Scraper?

DuckDuckGo's Instant Answer API returns topic summaries, not the full list of search results, and there is no public search results API. Scrapier reads DuckDuckGo's public results for any keyword, mode and region with one API key, at a price you know before the call runs.

[Get a free API key →](https://app.scrapier.io/sign-up)[See pricing](https://scrapier.io/pricing/)

**0**Credits for a failed call

Any non-2xx response is free, so retries cost nothing.

**$1.20**Per 1,000 calls on Scale

At 1 credit a call. Flat per-call pricing, no compute units or bandwidth to estimate.

**0**Setup steps on DuckDuckGo

No account, app or key to create on DuckDuckGo.

**1 key**For 35 platforms

The same key and JSON envelope cover Google, Bing, YouTube, Amazon, LinkedIn and more.

| Feature | Scrapier DuckDuckGo Scraper | Official API | DIY scraper |
| --- | --- | --- | --- |
| Whose data | DuckDuckGo's public results | No public search API | Any public results page |
| Setup | One API key | No public search API | Proxies, browsers, parsers |
| Maintenance | Handled by Scrapier | No public search API | Breaks on layout changes |
| Cost | From $1.20 per 1,000 calls | No public search API | Servers, proxies and engineering time |
| AI agents | MCP server included | No public search API | Build your own |

FAQ

## Frequently asked questions

### What does the DuckDuckGo endpoint return?

For each web result: title, URL, hostname, description, the raw description, a favicon URL, position and the keyword you searched. The response also echoes mode, region and safe search, with the page number, page size and next\_cursor.

### Can I get DuckDuckGo images, videos or news?

Yes. Set search\_mode to images, videos or news instead of default (web). The mode is locked into the cursor on the first call, so every following page stays in the same mode.

### Can I search DuckDuckGo in another region?

Yes. region takes a DuckDuckGo region code such as wt-wt (no region), us-en or uk-en. safe\_search sets the filter level. Both are locked into the cursor.

### How many DuckDuckGo results can I get?

As many as DuckDuckGo shows publicly. Each call returns one page with next\_cursor; pass it back as cursor for the next page. Each page is one call at 1 credit.

### Does DuckDuckGo have an official search API?

DuckDuckGo's Instant Answer API returns topic summaries, not the full results list, and there is no public search results API. Scrapier returns the results list itself as JSON.

### Can I search several keywords in one call?

No. Each call takes one keyword in query. To run a list, loop over it with up to 3 requests in parallel per key. Throttled (429) and failed calls cost nothing.

### Is it legal to scrape DuckDuckGo?

It depends on what you collect, where you are and how you use it, so this is not legal advice. Scrapier returns publicly visible DuckDuckGo data only. Some results can hold personal data under GDPR or CCPA, so collect only what you have a legitimate reason to use and check DuckDuckGo's terms for your case.

### Can I connect DuckDuckGo data to other tools?

Yes. Any tool that can make an HTTP request works: n8n, Make, Zapier, Google Sheets, Airbyte or your own code. Send your key in the X-API-Key header and read the JSON under data.

### Can I get DuckDuckGo data through an MCP server?

Yes. Run claude mcp add -t http scrapier https://mcp.scrapier.io/mcp with your key in an X-API-Key header. The agent finds the right DuckDuckGo endpoint with search\_endpoints and calls it with run\_scrape, in Claude Code, Cursor or Windsurf.

### DuckDuckGo Scraper not working?

Check the status code first: 401 means the X-API-Key header is missing, 403 an invalid key, 402 no credits left, 429 too many requests (wait Retry-After seconds). If the response still looks wrong, report it with the request and the response.

### How much does the DuckDuckGo scraper cost?

The DuckDuckGo endpoint costs 1 credit per successful call, whether the page holds one result or ten, so 1,000 searches cost $1.58 on Pro. Failed calls are free. Plans: Hobby $29 for 15,000 credits, Pro $79 for 50,000, Scale $299 for 250,000, Enterprise custom. A free tier lets you try it first.

### What are the DuckDuckGo scraper rate limits?

Run up to 3 requests in parallel per API key. If you go faster, the API answers 429 with a Retry-After header: wait that many seconds and retry. 429 and 5xx responses are never billed, and long-running calls need a client timeout of 210 seconds or more.

### How do I scrape DuckDuckGo with Python?

Use the requests library: requests.get("https://proxy.scrapier.io/api/v2/duckduckgo-search/", headers={"X-API-Key": key}, params={"query": "python programming"}, timeout=210). The response is JSON, so read r.json()\["data"\]\["results"\] directly; there is no HTML to parse. Loop over your list for more.

Other platforms

## You might also like

[### Google

18 endpoints](https://scrapier.io/scrapers/google/)[### Bing

1 endpoint](https://scrapier.io/scrapers/bing/)[### Yahoo

1 endpoint](https://scrapier.io/scrapers/yahoo/)[### Ecosia

1 endpoint](https://scrapier.io/scrapers/ecosia/)[### Yandex

1 endpoint](https://scrapier.io/scrapers/yandex/)[### Baidu

1 endpoint](https://scrapier.io/scrapers/baidu/)

Get started

## Start pulling DuckDuckGo data in 60 seconds

Free API key. No sales call, no proxy setup, and failed calls are free.

[Get your API key →](https://app.scrapier.io/sign-up)[Browse all 1 endpoints](#endpoints)

---
Canonical page: https://scrapier.io/scrapers/duckduckgo/
Site index for AI agents: https://scrapier.io/llms.txt
