DuckDuckGo News API Documentation
DuckDuckGo News API returns the news articles DuckDuckGo News shows for a query, in the same order.
Each article includes its title, link, source, the time since publication (date), the publication time in ISO 8601 (iso_date), a snippet, the publisher's favicon and, for most articles, a thumbnail.
A page holds up to 30 articles, and a query has up to 4 pages.
The date text is always in English, whatever the locale.
API Parameters
Search Query
-
- Name
-
q - Required
- Required
- Description
-
Parameter defines the query you want to search on DuckDuckGo News, at most 500 characters.
Localization
-
- Name
-
locale - Required
- Optional
- Description
-
Defines the region and language of the news feed. The default value is
us-en. Check the full list of supported DuckDuckGo locales. Regions where DuckDuckGo News has no articles are not accepted:bg-bg,co-es,hr-hr,cz-cs,ee-et,gr-el,hu-hu,lv-lv,lt-lt,no-no,pe-es,ro-ro,sk-sk,sl-sl,ua-uk, andve-es.
Filters
-
- Name
-
time_period - Required
- Optional
- Description
-
Limits results to articles published within the time period. Available values are:
-
any_timeDefault past_daypast_weekpast_month
-
Pagination
-
- Name
-
next_page_token - Required
- Optional
- Description
-
Retrieves the next page of articles. Pass the
pagination.next_page_tokenvalue from the previous response, together with the sameq. The token keeps thelocaleandtime_periodof the first page. A query has up to 4 pages, about 100 articles, and the last page returns no token.
Engine
-
- Name
-
engine - Required
- Required
- Description
-
Parameter defines an engine that will be used to retrieve real-time data. It must be set to
duckduckgo_news.
API key
-
- Name
-
api_key - Required
- Required
- Description
-
The
api_keyauthenticates your requests. Use it as a query parameter (https://www.searchapi.io/api/v1/search?api_key=YOUR_API_KEY) or in the Authorization header (Bearer YOUR_API_KEY).
Zero Data Retention
-
- Name
-
zero_retention - Enterprise Only
- Enterprise Only
- Required
- Optional
- Description
-
Set this parameter to
trueto disable all logging and persistent storage. No request parameters, HTML, or JSON responses are stored or logged. Suitable for high-compliance use cases. Debugging and support may be limited while enabled.
API Examples
Full Response
https://www.searchapi.org/api/v1/search?engine=duckduckgo_news&q=openai
- Python
- Node
- Ruby
- Java
- Go
- PHP
- Bash
- R
- Kotlin
- Swift
- C#
- C
- C++
- requests
import requests
url = "https://www.searchapi.org/api/v1/search"
params = {
"engine": "duckduckgo_news",
"q": "openai"
}
response = requests.get(url, params=params)
print(response.text)
{
"search_metadata": {
"id": "search_nKLZyHY5OozCrhzughbGtZAn",
"status": "Success",
"created_at": "2026-11-12T13:34:52Z",
"request_time_taken": 1.25,
"parsing_time_taken": 0.01,
"total_time_taken": 1.25,
"request_url": "https://duckduckgo.com/?t=h_&q=openai&ia=news&iar=news&kl=us-en",
"html_url": "https://www.searchapi.io/api/v1/searches/search_lO15gDA5Xcb3o46ndjhQOYd4.html",
"json_url": "https://www.searchapi.io/api/v1/searches/search_M4m29Yl7Tp6nyYkDYqlxCydi"
},
"search_parameters": {
"engine": "duckduckgo_news",
"q": "openai",
"locale": "us-en",
"time_period": "any_time"
},
"organic_results": [
{
"position": 1,
"title": "OpenAI lets you claim your business in ChatGPT and set up a custom agentic AI customer sales rep",
"link": "https://venturebeat.com/technology/openai-lets-you-claim-your-business-in-chatgpt-and-set-up-a-custo...",
"source": "VentureBeat",
"date": "2 days ago",
"iso_date": "2026-11-10T21:49:00Z",
"snippet": "Depending on the business, OpenAI can verify a claim through a business phone number, email address, website domain or Shopify account.",
"favicon": "https://external-content.duckduckgo.com/ip3/venturebeat.com.ico",
"thumbnail": "https://venturebeat.com/_next/image?url=https%3A%2F%2Fimages.ctfassets.net%2Fjdtwqhzvc2n1%2F5AKKXifZ..."
},
"..."
],
"pagination": {
"next_page_token": "aHR0cHM6Ly9kdWNrZHVja2dvLmNvbS9uZXdzLmpzP3E9b3BlbmFpJmw9dXMtZW4mbz1qc29uJnA9LTEmcz0zMCZ2cWQ9NC0zMDE2MDU3ODUxODA4MjcyMDk3NzY1MDg2NDE4NDc0MjMxNDQ1MzYmbm9hbXA9MSZ1PWJpbmc"
}
}
News from the Past Day
https://www.searchapi.org/api/v1/search?engine=duckduckgo_news&q=tesla&time_period=past_day
- Python
- Node
- Ruby
- Java
- Go
- PHP
- Bash
- R
- Kotlin
- Swift
- C#
- C
- C++
- requests
import requests
url = "https://www.searchapi.org/api/v1/search"
params = {
"engine": "duckduckgo_news",
"q": "tesla",
"time_period": "past_day"
}
response = requests.get(url, params=params)
print(response.text)
{
"search_metadata": {
"id": "search_aollnwRi7zTV5u6bcxdc2Jlb",
"status": "Success",
"created_at": "2026-11-12T13:34:54Z",
"request_time_taken": 1.27,
"parsing_time_taken": 0.0,
"total_time_taken": 1.28,
"request_url": "https://duckduckgo.com/?t=h_&q=tesla&ia=news&iar=news&kl=us-en&df=d",
"html_url": "https://www.searchapi.io/api/v1/searches/search_22Qr0XqggRe53L6A54LV8Is2.html",
"json_url": "https://www.searchapi.io/api/v1/searches/search_TylHfh4surkFrWQgqstmgzmo"
},
"search_parameters": {
"engine": "duckduckgo_news",
"q": "tesla",
"locale": "us-en",
"time_period": "past_day"
},
"organic_results": [
{
"position": 1,
"title": "Company offers to resurrect the Cybertruck after Tesla ends production",
"link": "https://www.msn.com/en-us/autos/general/company-offers-to-resurrect-the-cybertruck-after-tesla-ends-...",
"source": "Chron",
"date": "3 hours ago",
"iso_date": "2026-11-12T11:01:44Z",
"snippet": "They even offered to create a new Cybertruck.",
"favicon": "https://external-content.duckduckgo.com/ip3/www.msn.com.ico",
"thumbnail": "https://img-s-msn-com.akamaized.net/tenant/amp/entityid/AA2hhXy8.img?w=1280&h=854&m=4&q=60"
},
"..."
]
}
News for a Region
https://www.searchapi.org/api/v1/search?engine=duckduckgo_news&locale=de-de&q=bundestag
- Python
- Node
- Ruby
- Java
- Go
- PHP
- Bash
- R
- Kotlin
- Swift
- C#
- C
- C++
- requests
import requests
url = "https://www.searchapi.org/api/v1/search"
params = {
"engine": "duckduckgo_news",
"q": "bundestag",
"locale": "de-de"
}
response = requests.get(url, params=params)
print(response.text)
{
"search_metadata": {
"id": "search_B7Rc8nOV7afp9KBskHS03Lya",
"status": "Success",
"created_at": "2026-11-12T13:34:55Z",
"request_time_taken": 1.27,
"parsing_time_taken": 0.0,
"total_time_taken": 1.27,
"request_url": "https://duckduckgo.com/?t=h_&q=bundestag&ia=news&iar=news&kl=de-de",
"html_url": "https://www.searchapi.io/api/v1/searches/search_itN6NUvUORI6pP5KmipHZHyq.html",
"json_url": "https://www.searchapi.io/api/v1/searches/search_AwhKSmCNUOKnW7ZAbwiAg2W0"
},
"search_parameters": {
"engine": "duckduckgo_news",
"q": "bundestag",
"locale": "de-de",
"time_period": "any_time"
},
"organic_results": [
{
"position": 1,
"title": "Antrag fordert Stopp von „EU-Armutsmigration\"",
"link": "https://www.bundestag.de/dokumente/textarchiv/2026/kw46-de-armutsmigration-1231498",
"source": "Deutscher Bundestag",
"date": "14 hours ago",
"iso_date": "2026-11-12T00:00:00Z",
"snippet": "Der Bundestag debattiert am Donnerstag, 12. November 2026, über einen Antrag mit dem Titel „EU-Armutsmigration sofort stoppen - Zugang zu deutschen Sozialleistungen massiv",
"favicon": "https://external-content.duckduckgo.com/ip3/www.bundestag.de.ico",
"thumbnail": "https://www.bundestag.de/resource/image/1231638/3x2/475/316/e456ae622aa422a101a0792c7cecda5e/7DFB80E..."
},
"..."
]
}
Next Page
https://www.searchapi.org/api/v1/search?engine=duckduckgo_news&next_page_token=aHR0cHM6Ly9kdWNrZHVja2dvLmNvbS9uZXdzLmpzP3E9b3BlbmFpJmw9dXMtZW4mbz1qc29uJnA9LTEmcz0zMCZ2cWQ9NC0zMDE2MDU3ODUxODA4MjcyMDk3NzY1MDg2NDE4NDc0MjMxNDQ1MzYmbm9hbXA9MSZ1PWJpbmc&q=openai
- Python
- Node
- Ruby
- Java
- Go
- PHP
- Bash
- R
- Kotlin
- Swift
- C#
- C
- C++
- requests
import requests
url = "https://www.searchapi.org/api/v1/search"
params = {
"engine": "duckduckgo_news",
"q": "openai",
"next_page_token": "aHR0cHM6Ly9kdWNrZHVja2dvLmNvbS9uZXdzLmpzP3E9b3BlbmFpJmw9dXMtZW4mbz1qc29uJnA9LTEmcz0zMCZ2cWQ9NC0zMDE2MDU3ODUxODA4MjcyMDk3NzY1MDg2NDE4NDc0MjMxNDQ1MzYmbm9hbXA9MSZ1PWJpbmc"
}
response = requests.get(url, params=params)
print(response.text)
{
"search_metadata": {
"id": "search_odCkzTB31Cd0TZJZOiNOjMTM",
"status": "Success",
"created_at": "2026-11-12T13:34:56Z",
"request_time_taken": 1.36,
"parsing_time_taken": 0.01,
"total_time_taken": 1.37,
"request_url": "https://duckduckgo.com/?t=h_&q=openai&ia=news&iar=news&kl=us-en",
"html_url": "https://www.searchapi.io/api/v1/searches/search_DZPecfTP9IVCPvXtRRFeA8PV.html",
"json_url": "https://www.searchapi.io/api/v1/searches/search_dF86kmC2UJI6cwP6OOAUWeiE"
},
"search_parameters": {
"engine": "duckduckgo_news",
"q": "openai",
"locale": "us-en",
"time_period": "any_time",
"next_page_token": "aHR0cHM6Ly9kdWNrZHVja2dvLmNvbS9uZXdzLmpzP3E9b3BlbmFpJmw9dXMtZW4mbz1qc29uJnA9LTEmcz0zMCZ2cWQ9NC0zMDE2MDU3ODUxODA4MjcyMDk3NzY1MDg2NDE4NDc0MjMxNDQ1MzYmbm9hbXA9MSZ1PWJpbmc"
},
"organic_results": [
{
"position": 1,
"title": "OpenAI pares fundraising goal, now seeking up to $20 billion in latest round",
"link": "https://www.msn.com/en-us/money/markets/openai-pares-fundraising-goal-now-seeking-up-to-20-billion-i...",
"source": "CNBC",
"date": "12 days ago",
"iso_date": "2026-10-31T19:56:23Z",
"snippet": "The funding round is still in progress and has not closed, so the figures are subject to change, a person directly familiar with the deal told CNBC.",
"favicon": "https://external-content.duckduckgo.com/ip3/www.msn.com.ico"
},
"..."
],
"pagination": {
"next_page_token": "aHR0cHM6Ly9kdWNrZHVja2dvLmNvbS9uZXdzLmpzP3E9b3BlbmFpJmw9dXMtZW4mbz1qc29uJnA9LTEmcz02MCZ2cWQ9NC0zMDE2MDU3ODUxODA4MjcyMDk3NzY1MDg2NDE4NDc0MjMxNDQ1MzYmbm9hbXA9MSZ1PWJpbmc"
}
}