Duckduckgo Search
Search for Duckduckgo results based on keywords.
If you already know that you want to use Duckduckgo Search, this page is the one you should read. It shows the required input, the filters you can apply, how pagination works, and what localization controls are available.
At a Glance
| Field | Value |
|---|---|
| Name | Duckduckgo Search |
| Scraper | duckduckgo_search |
| Engine | duckduckgo_search |
| Website | DuckDuckGo |
| Website URL | Duckduckgo.com |
| Output Format | json |
| Version | 1.0.0 |
| Parameter Count | 5 |
| Parameter Groups | Search Query (1), Advanced Filters (2), Localization (1), Request Controls (1) |
Required Parameters
If you are sending your first request with this engine, start here. Requiredness is based on properties.<field>.must, not the top-level required array.
| Field | Type | Group | Description |
|---|---|---|---|
q | string | Search Query | The keyword or phrase you want this search engine to look up. |
Available Parameters
The sections below follow the same parameter groups as the backend, but the field descriptions have been rewritten into shorter, user-facing wording so they are easier to scan.
Search Query
| Field | Type | Required | Description |
|---|---|---|---|
q | string | Yes | The keyword or phrase you want this search engine to look up. |
Advanced Filters
| Field | Type | Required | Description |
|---|---|---|---|
df | string | No | Date filter used to keep only recent results or a custom date range. |
safe | number | No | Safe-search level that controls adult-content filtering. |
Additional Constraints
safe:Default:1;Options: 3 options. Examples:1,-1,-2
Localization
| Field | Type | Required | Description |
|---|---|---|---|
kl | string | No | DuckDuckGo region code. |
Additional Constraints
kl:Default:us-en;Options: 64 options. Examples:ar-es,au-en,at-de,be-fr,be-nl
Request Controls
| Field | Type | Required | Description |
|---|---|---|---|
no_cache | boolean | No | Skip cached results and force a fresh fetch. |
Additional Constraints
no_cache:Default:false
