Search DuckDuckGo News
Search DuckDuckGo News by keyword, region and time, with each article's source, date and image.
Headers
Get your API keyAPI key (`sfk_...`)
What to search the news for, e.g. `electric cars`.
min 1 chars · max 500 chars
Only results from the past `day`, `week`, `month` or `year`. Default: any time.
one of: day, week, month, year
Pass `page.nextCursor` from the previous response to get the next page.
min 1 chars · max 4096 chars
Two-letter country code of the results' region, e.g. `GB` or `DE`. Default: `US`.
pattern: ^[A-Z]{2}$
Two-letter language code for a country with several, e.g. `fr` with `CH`. Default: the region's first language.
pattern: ^[a-z]{2}$
Endpoint-specific response payload.
Always `found`: no match is an empty list.
one of: found, not_found
The query that was searched.
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.
Headline.
Article URL.
Opening text, as plain text.
Publication, e.g. `Runner's World`.
Published, ISO 8601 UTC.
Age as DuckDuckGo shows it, e.g. `9 days ago`.
Article image URL.
Pagination state for the current page.
Whether another page is available.
Cursor to pass in the next request when more pages exist; null on the last page.
Metadata describing the request and billing outcome.
Unique request identifier for tracing this API call.
min 1 chars
Credits charged for this request.
≥ 0
Public API version that served the response.
one of: v1
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
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.