Skip to content

DuckDuckGo News Results: Query to Ranked JSON

Run a news query against DuckDuckGo and receive the ranked article list in a single API call.

OUTPUT FORMATSHTMLJSONMarkdown

Each result includes the headline, publisher source, snippet text, publish timestamp, thumbnail URL, and article link. Pagination is handled within the call.

What Each DuckDuckGo News Query Returns

Every result in the ranked array carries six fields: headline, source publication, snippet, publish timestamp, thumbnail, and article URL. The API submits your query to DuckDuckGo News, paginates through the results, and returns the ranked article array as structured JSON. You can pass an optional country_code, a time range, and a result count to shape the response.

Field and Control Map

Use this map to decide which request control affects which part of the response.

  • headline — affected by the query string and result count.
  • source publication — affected by country_code when publishers vary by geography.
  • snippet — affected by time range and query specificity.
  • publish timestamp — affected by time range; use it to filter recency.
  • thumbnail — returned per result; no separate control.
  • article URL — the canonical link for each ranked article.

Request controls:

  • country_code — routes through a residential IP in that country; useful when content varies by geo.
  • time range — limits results to a recency window.
  • result count — caps the number of ranked articles returned.
  • extract_rules — CSS selectors mapped to field names for custom JSON output.
  • ai_extract_rules — a natural-language spec for AI-driven extraction.

Common Jobs for DuckDuckGo News Queries

Three jobs come up often:

  1. Brand mention tracking — pull every news article DuckDuckGo News surfaces for the brands, topics, or keywords you monitor. The privacy-focused index can surface stories that other news indexes miss.
  2. Collecting article summaries — use the snippet and headline fields for competitor analysis, content strategy assessment, and positioning work.
  3. Spotting trending news topics — collect trending topics to stay informed on industry shifts and emerging market opportunities.

Worked Example: Monitoring a Brand Across Two Countries

Suppose you want to monitor a fictional brand, "Acme Robotics," in the US and UK. You send two requests with the same query string but different country_code values. Each response returns a ranked array. You then map extract_rules so that headline, source, snippet, timestamp, and article URL land in named JSON fields. Because country_code routes through a residential IP in the target country, the two arrays can differ when publishers or editions vary by geography. If you also set a time range, both arrays are limited to that recency window. If the target throttles aggressive patterns, space out requests or use multiple sessions; the API itself enforces concurrency limits per plan, not per-target rate limits.

Setup in Under Five Minutes

Code samples are available for Python, Node.js, Ruby, PHP, Go, and cURL. A request builder in the dashboard lets you test without writing code. The Python SDK (or Node, Go, PHP, or Ruby) turns a DuckDuckGo News pull into a single function call per page, with no proxy rotation or headless Chrome to manage on your side.

How the DuckDuckGo News Results API Works

  1. Create an account to get an API key and 1,000 free credits.
  2. Install an SDK for your stack (Python, Node, Go, PHP, Ruby, or Java) or use plain cURL.
  3. Send the DuckDuckGo News URL with your API key as a parameter. The renderer executes the page in a real browser, rotates the IP, and returns the response.
  4. Add advanced parameters as needed: render_js for JavaScript, stealth_proxy for CAPTCHAs, country_code for geo-targeting, and ai_extract_rules for natural-language data extraction.

Plan and Credit Reference

The following plan structure and credit costs reflect the captured reference period and should be checked against current pricing before purchase. API credits are valid for one month and do not roll over. Requests start at 1 credit each. JavaScript rendering costs 5 credits per successful request. Premium proxies cost 10 or 25 credits depending on whether JS rendering is disabled or enabled. Stealth proxy costs 75 credits. Geotargeting routes through 200+ countries and territories (40+ on classic proxies). All prices are exclusive of VAT.

Why Use a Dedicated DuckDuckGo News API

Manual collection from DuckDuckGo News is slow, limited, and hard to scale. A dedicated API handles proxy rotation, headless browser rendering, and anti-bot measures so your team can focus on the data. The platform scales with thousands of headless browsers and rotating proxies, and returns results in 1–5 seconds across most sites, including JavaScript-heavy ones. It does not collect or store personal data from scraped sites unless the user explicitly requests it.

Plan Comparison (Captured Reference)
PlanPriceAPI CreditsConcurrent RequestsPriority Email SupportDedicated Account ManagerTeam Management
Hobby$19 /mo75,00025Not includedNot includedNot included
Freelance$49 /mo250,00050Not includedNot includedNot included
Startup (Recommended)$99 /mo1,000,000100Not includedNot includedNot included
Business$249 /mo3,000,000200IncludedIncludedIncluded
Business +$599 /mo8,000,000400IncludedIncludedIncluded
Enterprise 14$999 /mo14,000,000500IncludedIncludedIncluded
Enterprise 24$1,599 /mo24,000,000600IncludedIncludedIncluded
Enterprise 41 (Recommended)$2,399 /mo41,000,000700IncludedIncludedIncluded
Enterprise 69$3,599 /mo69,000,000800IncludedIncludedIncluded
Enterprise 120$5,799 /mo120,000,000900IncludedIncludedIncluded

Prices are exclusive of VAT. API credits are valid for one month and do not roll over. This table reflects the captured reference period; check current pricing before purchase.

Frequently asked questions

Do I need an account to scrape DuckDuckGo News?

No external account is required. Sign up for an API key (1,000 free credits, no card), send the URL, and the service handles the rest.

Can I scrape DuckDuckGo News from a specific country?

Yes. Pass country_code on the request to route through a residential IP in that country. This is useful when content varies by geography.

What's the rate limit for scraping DuckDuckGo News?

The API has concurrency limits per plan, not per-target rate limits. If the target throttles aggressive patterns, space out requests or use multiple sessions.

How do I get structured JSON from DuckDuckGo News?

You have two options. Supply extract_rules that pair CSS selectors with the field names you want, or supply ai_extract_rules with a natural-language description of the fields. Either way, the response arrives as parsed JSON rather than raw HTML.

Which programming languages can I use to scrape DuckDuckGo News?

Any language. SDKs are published for Python, Node.js, Go, PHP, Ruby, and Java. Plain cURL works too. Pick whatever your stack already uses.

How much does it cost to scrape DuckDuckGo News?

1,000 free credits on signup, no card required. Paid plans start at $19/month for higher volume and concurrency. Credit cost per request depends on options: 5 credits for JS rendering, 25 for premium_proxy with JS, 75 for stealth_proxy.