For the complete documentation index, see llms.txt. This page is also available as Markdown.

DuckDuckGo SERP API Parameters Guide

Review DuckDuckGo SERP API parameters for search queries, regions, and result options to collect structured DuckDuckGo data.

With Talordata SERP API, you can configure DuckDuckGo Search queries, including geographic targeting, pagination output options.

q ,Search Query(Required)

Define the search query used for data crawling (default value: q=pizza). Any keywords in any language are supported.

Example Request:

Example with q:pizza parameter

curl -X POST https://serpapi.talordata.net/serp/v1/request \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -H "Authorization: Bearer token" \
 -d "engine=duckduckgo" \
 -d "q=pizza" \
 -d "json=1"

Geographical Location

kl ,Location(Optional)

Specify the interface language and region for search results (e.g., "zh-cn"

provides a Simplified Chinese interface and prioritizes displaying results from the China region).

Example Request:

Example results for q : pizza,kl:japan

curl -X POST https://serpapi.talordata.net/serp/v1/request \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -H "Authorization: Bearer token" \
 -d "engine=duckduckgo" \
 -d "q=pizza" \
 -d "json=1" \
 -d "kl=Japan"

Pagination

start ,Result offset(Optional)

Set the starting point for search result pagination (e.g., "start=30" means skipping the first 30 results and starting to display from the 31st result). Rules:

  • start=30 → Skips first 30 results (page 2)

  • Max: start=500 (result quality declines after ~16 pages)

Example Request:

Example results for q : pizza,start:2

curl -X POST https://serpapi.talordata.net/serp/v1/request \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -H "Authorization: Bearer token" \
 -d "engine=duckduckgo" \
 -d "q=pizza" \
 -d "json=1" \
 -d "start=2"

Advanced Filters

df ,Filter By Date(Optional)

Filter search results by time range ('d = past 24 hours', 'w = past week', 'm = past month').

Filters results by time range:

Value
Time Range
Use Case

d

Last 24 hours

Time-sensitive queries

w

Last 1 week

Balanced freshness/coverage

m

Last 1 month

Default range

y

Last 1 year

Historical data

Example Request:

Example results for q : pizza,df:y

kp ,Safe(Optional)

Set the search content safety filtering level (Strict / Moderate / Disabled) to filter sensitive information such as adult content, violence, etc.

Safe search filtering:

  • kp=-2: Strict (default)

  • kp=-1: Moderate

  • kp=1: Disabled (may trigger CAPTCHA)

Example Request:

Example results for q : pizza,kp:1

If you need further assistance, feel free to contact us via live chat or email [email protected].

Last updated