DuckDuckGo

List DuckDuckGo search suggestions

List DuckDuckGo's search suggestions for the start of a query, in any region.

GET/v1/duckduckgo/search/suggest
1credit
x-api-keystringheader

API key (`sfk_...`)

Parameters
3
querystringrequiredquery

The start of a search to complete, e.g. `marat`.

min 1 chars · max 200 chars

countrystringoptionalquery

Two-letter country code of the results' region, e.g. `GB` or `DE`. Default: `US`.

pattern: ^[A-Z]{2}$

languagestringoptionalquery

Two-letter language code for a country with several, e.g. `fr` with `CH`. Default: the region's first language.

pattern: ^[a-z]{2}$

Response fields
12

Endpoint-specific response payload.

datalookupStatus
string

Always `found`: no suggestion is an empty list.

one of: found, not_found

dataquery
string

The text that was completed.

dataregion
string

DuckDuckGo's region code the results are for, e.g. `us-en`.

Suggested searches, best first.

dataqueries[]text
string

Suggested search.

Metadata describing the request and billing outcome.

metarequestId
string

Unique request identifier for tracing this API call.

min 1 chars

metacreditsCharged
integer

Credits charged for this request.

≥ 0

metaversion
string

Public API version that served the response.

one of: v1

metastale
booleanoptional

Present, and `true`, only when the source couldn't be reached and this is the last good answer for the same request instead, up to 24 hours old. Absent on every live answer.

one of: true

metafetchedAt
stringoptional

When a stale answer (`stale: true`) was originally fetched (ISO 8601, UTC). Absent on every live answer.

Code example

curl "https://api.socialfetch.dev/v1/duckduckgo/search/suggest?query=marat" \
  -H "x-api-key: YOUR_API_KEY"

Responses

DuckDuckGo search suggestions.