New: the Scrapier MCP server. Every scraper in Claude Code with one command. See how →

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.

Copy for your AI agent
1DuckDuckGo endpoint
1credit per successful call
0credits for a failed call
1need 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.

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.

DuckDuckGoSearchLive

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 →
PlanPrice / moCredits / moPer 1,000 calls
Free$0Free tier—
Hobby$2915,000$1.93
Pro$7950,000$1.58
Scale$299250,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:

  1. Create a free Scrapier accountSign up with your email and copy your API key.
  2. Add your keywordOne search term per call in query.
  3. Pick a modesearch_mode: default for web, or images, videos or news.
  4. Pick a region and safe searchregion takes a code such as wt-wt, us-en or uk-en; safe_search sets the filter level.
  5. Page through the resultsPass next_cursor back as cursor for the next page; mode, region and safe search stay locked in.
  6. Run the requestOne 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 resultsJSON 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.

Searchpython 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 thisParameterAnd you can get
KeywordqueryWeb results with title, URL, hostname and description
Keyword and modequery · search_modeImage, video or news results instead of web
Region and filterregion · safe_searchResults 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. 1search
  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. 1search
  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. 1search
  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.

0Credits for a failed call

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

$1.20Per 1,000 calls on Scale

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

0Setup steps on DuckDuckGo

No account, app or key to create on DuckDuckGo.

1 keyFor 35 platforms

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

FeatureScrapier DuckDuckGo ScraperOfficial APIDIY scraper
Whose dataDuckDuckGo's public resultsNo public search APIAny public results page
SetupOne API keyNo public search APIProxies, browsers, parsers
MaintenanceHandled by ScrapierNo public search APIBreaks on layout changes
CostFrom $1.20 per 1,000 callsNo public search APIServers, proxies and engineering time
AI agentsMCP server includedNo public search APIBuild 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.

Get started

Start pulling DuckDuckGo data in 60 seconds

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