DuckDuckGo

Get a DuckDuckGo instant answer

Get DuckDuckGo's instant answer for a topic: a summary, facts, a direct answer and related links.

GET/v1/duckduckgo/instant-answer
1credit
x-api-keystringheader

API key (`sfk_...`)

Parameters
1
querystringrequiredquery

A topic, name or question, e.g. `Albert Einstein`.

min 1 chars · max 500 chars

Response fields
35

Endpoint-specific response payload.

datalookupStatus
string

`found` when DuckDuckGo has an answer for the topic; `not_found` when it has none.

one of: found, not_found

dataquery
string

The topic that was asked.

dataheading
stringnullable

The topic's name.

datatype
stringnullable

`article`, `disambiguation`, `category`, `name`, `exclusive` or null.

dataentity
stringnullable

What the topic is, e.g. `scientist`.

A summary of the topic.

dataabstracttext
stringnullable

Summary text.

dataabstractsource
stringnullable

Where the summary is from.

dataabstracturl
stringnullable

The summary's page.

A direct answer, for questions DuckDuckGo can answer.

dataanswertext
stringnullable

A direct answer.

dataanswertype
stringnullable

What made it, e.g. `calc`.

A definition, for words.

datadefinitiontext
stringnullable

A dictionary definition.

datadefinitionsource
stringnullable

Where it is from.

datadefinitionurl
stringnullable

Its page.

dataimage
stringnullable

Image URL.

dataofficialWebsite
stringnullable

The official site.

Facts about the topic.

datainfobox[]label
string

Fact name, e.g. `Born`.

datainfobox[]value
string

Fact value.

Primary links, such as the official site.

dataresults[]text
string

Link text.

dataresults[]url
stringnullable

Link URL.

Related topics.

datarelatedTopics[]text
string

Link text.

datarelatedTopics[]url
stringnullable

Link URL.

dataredirect
stringnullable

A redirect target, for `!bang` queries.

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/instant-answer?query=Albert%20Einstein" \
  -H "x-api-key: YOUR_API_KEY"

Responses

DuckDuckGo's instant answer for a topic.