// request reference
DuckDuckGo Maps parameters
Send query parameters with GET /api/duckduckgo/maps. 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.
Map search
Search the first-party DuckDuckGo local endpoint inside a viewport.
qRequired place or category query.
Example / input hint: coffee
bboxtop,left,bottom,right rectangle; use instead of coordinates.
Example / input hint: 30.35,-97.90,30.10,-97.50
latViewport center latitude; requires longitude.
Example / input hint: 30.2672
lonViewport center longitude; requires latitude.
Example / input hint: -97.7431
strict_bboxExclude results outside the requested box.
truefalse// response
Work with the complete JSON response
Response groups include local_results. 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.