// request reference
DuckDuckGo Search parameters
Send query parameters with GET /api/duckduckgo/search. Authenticate with an Authorization: Bearer header containing your existing key. Keep keys on your server, not in browser code.
The groups below list every request field, including compatibility restrictions. Read the extended reference for detailed types, defaults, parameter combinations and additional examples.
Search query
Search DuckDuckGo through its first-party HTML application.
qRequired search text, up to 500 characters.
Example / input hint: coffee Austin Texas
klDuckDuckGo region and language token.
Example / input hint: us-en
safeDuckDuckGo safe-search level.
-1 Moderate (default)1 Strict-2 Offdfd, w, m, y, or YYYY-MM-DD..YYYY-MM-DD.
Example / input hint: w
Pagination
Control result count, offset, and search assistance.
startOffset from 0 through 10,000.
Example / input hint: 0
m1 through 50; mutually exclusive with search_assist.
Example / input hint: 10
search_assistUse DuckDuckGo query assistance.
truefalse// response
Work with the complete JSON response
Response groups include organic_results, search_metadata. Groups and fields depend on the upstream result.
The SDK examples use raise_for_error() or raiseForError() so API errors are not mistaken for successful results.