DuckDuckGo: The DuckDuckGo Search API is a tool that allows developers and businesses to integrate.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
DuckDuckGo web search: the organic results (url, title, plain and HTML snippet, result types, host, sublinks, date, site name, rating) and the other blocks of the same answer: ads, related searches, the knowledge panel, the AI answer when DuckDuckGo gives it inline, and the news, image and video strips. Blocks DuckDuckGo did not send are empty lists or null. Billing per call: 1 Credits.
The search query.
The results page, from 1. The first page holds 10 results, every later page 15; positions continue across pages.
Only results from the past day, week, month or year, or from a date range YYYY-MM-DD..YYYY-MM-DD.
A DuckDuckGo region code such as us-en, de-de or uk-en; wt-wt is no region.
DuckDuckGo's default is moderate.
This tool isn't marked read-only, so it may change something on the server or in an account you connected.
DuckDuckGo web search: the organic results (url, title, plain and HTML snippet, result types, host, sublinks, date, site name, rating) and the other blocks of the same answer: ads, related searches, the knowledge panel, the AI answer when DuckDuckGo gives it inline, and the news, image and video strips. Blocks DuckDuckGo did not send are empty lists or null. Billing per call: 1 Credits.
| Argument | Type | Description |
|---|---|---|
| q* | string | The search query. |
| page | integer | The results page, from 1. The first page holds 10 results, every later page 15; positions continue across pages. |
| time | string | Only results from the past day, week, month or year, or from a date range YYYY-MM-DD..YYYY-MM-DD. |
| region | string | A DuckDuckGo region code such as us-en, de-de or uk-en; wt-wt is no region. |
| safe_search | string | DuckDuckGo's default is moderate. |
{
"type": "object",
"required": [
"q"
],
"properties": {
"q": {
"type": "string",
"title": "Search Query",
"example": "nikola tesla",
"description": "The search query."
},
"page": {
"type": "integer",
"title": "Page",
"example": 2,
"description": "The results page, from 1. The first page holds 10 results, every later page 15; positions continue across pages."
},
"time": {
"type": "string",
"title": "Time",
"example": "week",
"description": "Only results from the past day, week, month or year, or from a date range YYYY-MM-DD..YYYY-MM-DD."
},
"region": {
"type": "string",
"title": "Region",
"example": "us-en",
"description": "A DuckDuckGo region code such as us-en, de-de or uk-en; wt-wt is no region."
},
"safe_search": {
"enum": [
"strict",
"moderate",
"off"
],
"type": "string",
"title": "Safe Search",
"description": "DuckDuckGo's default is moderate."
}
},
"additionalProperties": false
}DuckDuckGo's search suggestions for a partial query. Billing per call: 1 Credits.
| Argument | Type | Description |
|---|---|---|
| q* | string | The search query. |
| region | string | A DuckDuckGo region code such as us-en, de-de or uk-en; wt-wt is no region. |
{
"type": "object",
"required": [
"q"
],
"properties": {
"q": {
"type": "string",
"title": "Search Query",
"example": "nikola tesla",
"description": "The search query."
},
"region": {
"type": "string",
"title": "Region",
"example": "us-en",
"description": "A DuckDuckGo region code such as us-en, de-de or uk-en; wt-wt is no region."
}
},
"additionalProperties": false
}DuckDuckGo Images for a query (title, page url, image, thumbnail, width, height). Up to 100 images a page. Billing per call: 1 Credits.
| Argument | Type | Description |
|---|---|---|
| q* | string | The search query. |
| page | integer | The results page, from 1. |
| size | string | |
| time | string | Only images from the past day, week or month. |
| type | string | |
| color | string | |
| layout | string | |
| region | string | A DuckDuckGo region code such as us-en, de-de or uk-en; wt-wt is no region. |
| license | string | creative_commons is any Creative Commons license. |
| safe_search | string | DuckDuckGo's default is moderate. |
{
"type": "object",
"required": [
"q"
],
"properties": {
"q": {
"type": "string",
"title": "Search Query",
"example": "nikola tesla",
"description": "The search query."
},
"page": {
"type": "integer",
"title": "Page",
"description": "The results page, from 1."
},
"size": {
"enum": [
"small",
"medium",
"large",
"wallpaper"
],
"type": "string",
"title": "Size"
},
"time": {
"enum": [
"day",
"week",
"month"
],
"type": "string",
"title": "Time",
"description": "Only images from the past day, week or month."
},
"type": {
"enum": [
"photo",
"clipart",
"gif",
"transparent",
"line"
],
"type": "string",
"title": "Type"
},
"color": {
"enum": [
"color_only",
"monochrome",
"red",
"orange",
"yellow",
"green",
"blue",
"purple",
"pink",
"brown",
"black",
"gray",
"teal",
"white"
],
"type": "string",
"title": "Color"
},
"layout": {
"enum": [
"square",
"tall",
"wide"
],
"type": "string",
"title": "Layout"
},
"region": {
"type": "string",
"title": "Region",
"example": "us-en",
"description": "A DuckDuckGo region code such as us-en, de-de or uk-en; wt-wt is no region."
},
"license": {
"enum": [
"creative_commons",
"public_domain",
"share",
"share_commercially",
"modify",
"modify_commercially"
],
"type": "string",
"title": "License",
"description": "creative_commons is any Creative Commons license."
},
"safe_search": {
"enum": [
"strict",
"moderate",
"off"
],
"type": "string",
"title": "Safe Search",
"description": "DuckDuckGo's default is moderate."
}
},
"additionalProperties": false
}DuckDuckGo News for a query, newest coverage first as DuckDuckGo orders it (title, url, excerpt, source, date, image). About 25 articles a page. Billing per call: 1 Credits.
| Argument | Type | Description |
|---|---|---|
| q* | string | The search query. |
| page | integer | The results page, from 1. |
| time | string | Only articles from the past day, week or month. |
| region | string | A DuckDuckGo region code such as us-en, de-de or uk-en; wt-wt is no region. |
| safe_search | string | DuckDuckGo's default is moderate. |
{
"type": "object",
"required": [
"q"
],
"properties": {
"q": {
"type": "string",
"title": "Search Query",
"example": "nikola tesla",
"description": "The search query."
},
"page": {
"type": "integer",
"title": "Page",
"description": "The results page, from 1."
},
"time": {
"enum": [
"day",
"week",
"month"
],
"type": "string",
"title": "Time",
"description": "Only articles from the past day, week or month."
},
"region": {
"type": "string",
"title": "Region",
"example": "us-en",
"description": "A DuckDuckGo region code such as us-en, de-de or uk-en; wt-wt is no region."
},
"safe_search": {
"enum": [
"strict",
"moderate",
"off"
],
"type": "string",
"title": "Safe Search",
"description": "DuckDuckGo's default is moderate."
}
},
"additionalProperties": false
}DuckDuckGo's local results (its Places module and Maps tab): businesses and places with category, address, coordinates, phone, website, rating, review count, price level, opening hours, open now, amenities, photos, menu and sample reviews (rating, text, date). DuckDuckGo takes the listings from Tripadvisor or Yelp depending on the area; `source` names it. Name the place in the query ("coffee in berlin germany") or pass latitude and longitude; with neither, DuckDuckGo searches around the address the request leaves from, and a place name several countries share can resolve to the one nearest that address, so add the country. Billing per call: 1 Credits.
| Argument | Type | Description |
|---|---|---|
| q* | string | The search query. |
| latitude | number | Search around this point; give longitude with it. Results then carry their distance from it. |
| longitude | number | Search around this point; give latitude with it. |
{
"type": "object",
"required": [
"q"
],
"properties": {
"q": {
"type": "string",
"title": "Search Query",
"example": "nikola tesla",
"description": "The search query."
},
"latitude": {
"type": "number",
"title": "Latitude",
"example": 48.8566,
"description": "Search around this point; give longitude with it. Results then carry their distance from it."
},
"longitude": {
"type": "number",
"title": "Longitude",
"example": 2.3522,
"description": "Search around this point; give latitude with it."
}
},
"additionalProperties": false
}DuckDuckGo Videos for a query (title, url, description, duration, published, publisher, uploader, views, thumbnail). Up to 60 videos a page. Billing per call: 1 Credits.
| Argument | Type | Description |
|---|---|---|
| q* | string | The search query. |
| page | integer | The results page, from 1. |
| time | string | Only videos published in the past day, week or month. |
| region | string | A DuckDuckGo region code such as us-en, de-de or uk-en; wt-wt is no region. |
| license | string | |
| duration | string | short is under 5 minutes, medium 5 to 20, long over 20. |
| resolution | string | |
| safe_search | string | DuckDuckGo's default is moderate. |
{
"type": "object",
"required": [
"q"
],
"properties": {
"q": {
"type": "string",
"title": "Search Query",
"example": "nikola tesla",
"description": "The search query."
},
"page": {
"type": "integer",
"title": "Page",
"description": "The results page, from 1."
},
"time": {
"enum": [
"day",
"week",
"month"
],
"type": "string",
"title": "Time",
"description": "Only videos published in the past day, week or month."
},
"region": {
"type": "string",
"title": "Region",
"example": "us-en",
"description": "A DuckDuckGo region code such as us-en, de-de or uk-en; wt-wt is no region."
},
"license": {
"enum": [
"creative_commons",
"youtube"
],
"type": "string",
"title": "License"
},
"duration": {
"enum": [
"short",
"medium",
"long"
],
"type": "string",
"title": "Duration",
"description": "short is under 5 minutes, medium 5 to 20, long over 20."
},
"resolution": {
"enum": [
"high",
"standard"
],
"type": "string",
"title": "Resolution"
},
"safe_search": {
"enum": [
"strict",
"moderate",
"off"
],
"type": "string",
"title": "Safe Search",
"description": "DuckDuckGo's default is moderate."
}
},
"additionalProperties": false
}