DuckDuckGo

Search DuckDuckGo News

Search DuckDuckGo News by keyword, region and time, with each article's source, date and image.

GET/v1/duckduckgo/news
1credit
x-api-keystringheader

API key (`sfk_...`)

Parameters
5
querystringrequiredquery

What to search the news for, e.g. `electric cars`.

min 1 chars · max 500 chars

timestringoptionalquery

Only results from the past `day`, `week`, `month` or `year`. Default: any time.

one of: day, week, month, year

cursorstringoptionalquery

Pass `page.nextCursor` from the previous response to get the next page.

min 1 chars · max 4096 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
21

Endpoint-specific response payload.

datalookupStatus
string

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

one of: found, not_found

dataquery
string

The query that was searched.

dataregion
string

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

Articles, newest and most relevant first; about 30 a page. An article already returned on an earlier page is left out.

dataarticles[]title
string

Headline.

dataarticles[]url
string

Article URL.

dataarticles[]excerpt
stringnullable

Opening text, as plain text.

dataarticles[]source
stringnullable

Publication, e.g. `Runner's World`.

dataarticles[]publishedAt
stringnullable

Published, ISO 8601 UTC.

dataarticles[]relativeTime
stringnullable

Age as DuckDuckGo shows it, e.g. `9 days ago`.

dataarticles[]image
stringnullable

Article image URL.

Pagination state for the current page.

datapagehasMore
boolean

Whether another page is available.

datapagenextCursor
stringnullable

Cursor to pass in the next request when more pages exist; null on the last page.

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/news?query=electric%20cars" \
  -H "x-api-key: YOUR_API_KEY"

Responses

DuckDuckGo news articles for a query.