DuckDuckGo News API Documentation

GET   /api/v1/search?engine=duckduckgo_news

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, and ve-es.

Filters

  • Name
    time_period
    Required
    Optional
    Description

    Limits results to articles published within the time period. Available values are:

    • any_time Default
    • past_day
    • past_week
    • past_month

Pagination

  • Name
    next_page_token
    Required
    Optional
    Description

    Retrieves the next page of articles. Pass the pagination.next_page_token value from the previous response, together with the same q. The token keeps the locale and time_period of 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_key authenticates 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 true to 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

Full Response
GET
https://www.searchapi.org/api/v1/search?engine=duckduckgo_news&q=openai
Request
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)
Response
{
  "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

News from the Past Day
GET
https://www.searchapi.org/api/v1/search?engine=duckduckgo_news&q=tesla&time_period=past_day
Request
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)
Response
{
  "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

News for a Region
GET
https://www.searchapi.org/api/v1/search?engine=duckduckgo_news&locale=de-de&q=bundestag
Request
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)
Response
{
  "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

GET
https://www.searchapi.org/api/v1/search?engine=duckduckgo_news&next_page_token=aHR0cHM6Ly9kdWNrZHVja2dvLmNvbS9uZXdzLmpzP3E9b3BlbmFpJmw9dXMtZW4mbz1qc29uJnA9LTEmcz0zMCZ2cWQ9NC0zMDE2MDU3ODUxODA4MjcyMDk3NzY1MDg2NDE4NDc0MjMxNDQ1MzYmbm9hbXA9MSZ1PWJpbmc&q=openai
Request
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)
Response
{
  "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"
  }
}