Skip to content

Search DuckDuckGo organic results

POST/v1/tools/duckduckgo.serp.organic/callsNeeds an API key

Returns DuckDuckGo's organic results for a query, with related searches. Use it to check rankings on DuckDuckGo.

Tool duckduckgo.serp.organic on DuckDuckGo. Contract version 1, released 2026-10-27.

Over REST, send the input in the body. Over MCP, pass the same input to call_tool.

Both return the full response: the call's ID, status and cost, with this tool's result in output.

Input

querystringRequired

The search query.

countrystring· default us

Two-letter ISO 3166-1 country code of the region to search. Case-insensitive. DuckDuckGo sets the language of the results from it.

One of the 249 values of the countries list: ISO 3166-1 alpha-2 country codes, lowercase.

pageinteger· default 1

Page of results, 10 per page.

At least 1.

time_rangestring

Only results from the last day, week, month or year.

day
week
month
year

Output

A successful call returns these blocks in its output. A field not marked required can be null.

results

A list of rows. Always present, possibly empty.

positionintegerRequired

Rank among organic results, starting at 1.

titlestringRequired
urlstringRequired
snippetstring
displayed_urlstring

The address as DuckDuckGo shows it under the title.

A list of rows. Can be null.

querystringRequired