DuckDuckGo Scraper
DuckDuckGo search scraper that extracts comprehensive search results including organic results, ads, knowledge graph, news, inline images, videos, and related searches. Features localization, safe search, and date. Perfect for market research, SEO analysis, and competitive intelligence.
Input parameters
| PARAMETER | TYPE | REQ | DEFAULT | DESCRIPTION |
|---|---|---|---|---|
| query | string | yes | — | Search DuckDuckGo for this term. |
| localization | enum | no | us-en | Set the region and language for search results (e.g. `us-en`, `uk-en`, `fr-fr`, `de-de`, `jp-jp`). |
| safe | enum | no | moderate | Set the safe-search filter level. |
| date_filter | string | no | — | Filter results by date. |
| max_pages | integer | no | 2 | Set the maximum number of result pages to fetch. — drives your bill |
Worked examples
{
"query": "The Siliconimist Podcast"
}
Coverage
Code
curl
curl -X POST "https://api.apify.com/v2/acts/johnvc~DuckDuckGo-Scraper-for-serp-rankings/run-sync-get-dataset-items" \
-H "Authorization: Bearer $APIFY_TOKEN" \
-H "Content-Type: application/json" \
-d '{"query": "The Siliconimist Podcast"}'
Python
from apify_client import ApifyClient
client = ApifyClient("APIFY_TOKEN")
run = client.actor("johnvc/DuckDuckGo-Scraper-for-serp-rankings").call(
run_input={'query': 'The Siliconimist Podcast'}
)
for item in client.dataset(run.default_dataset_id).iterate_items():
print(item)
MCP
Apify's hosted MCP server loads this source from the URL below as the tool johnvc--DuckDuckGo-Scraper-for-serp-rankings. Sign in to Apify when your client asks (OAuth), or send an Apify token as an Authorization: Bearer header.
https://mcp.apify.com/?tools=johnvc/DuckDuckGo-Scraper-for-serp-rankings
Setup guide for Claude Code, VS Code and Cursor, with tool names and parameters →
Questions people ask
What does the DuckDuckGo Scraper return for a search?
It returns the results page as structured JSON, including organic listings, ads, the knowledge graph, news, inline images, videos and related searches for the query you pass.
How much does the DuckDuckGo Scraper cost per page?
The default Pay per page edition bills 0.0004 USD per results page processed. max_pages, which defaults to 2, is the main cost control, and there is a free tier on Apify.
Which regions and languages does the DuckDuckGo Scraper support?
It supports 42 localization codes such as us-en, uk-en, ca-en, au-en, de-de and jp-jp. Set the localization input, which defaults to us-en, to change the region and language of results.
Can I apply safe search or date filters in the DuckDuckGo Scraper?
Yes. The safe input sets the safe-search level and defaults to moderate, and date_filter restricts results by date. Only the query input is required.
Can Claude or Cursor use the DuckDuckGo Scraper as a tool?
Yes. The source is exposed as an MCP tool on Apify's hosted MCP server, so Claude, Cursor and other agents can call it, and it is also available over REST. Results are fetched on demand.