Search news with title, URL, source, excerpt, ISO date and image. Page with start in steps of 30. Filter by freshness or date_from: articles outside the filter are removed. Failed requests, and queries with no news, are never charged.
Run this endpoint
Endpoint
Parameters
Start with the required fields, then add optional filters only when your use case needs them.
Runnable path
1 required parameter needed before sending a request.
5 optional filters available.
string
Required
News search query (max 499 characters).
coffee shops
integer
Optional
Result offset in steps of 30 (0, 30, 60...), up to 300. Use next_start from the previous response. Default: 0.
0
string
Optional
Region and language as ll-cc, for example de-de. Default: us-en.
US
string
Optional
strict, moderate or off. Default: moderate.
off
string
Optional
Only articles newer than hour, day, week, month or year.
example
string
Optional
Only articles published on or after this date, YYYY-MM-DD in UTC.
2026-06-15
Errors
Handle these documented responses before retrying or showing customer-facing failures.
HTTP VALIDATION_ERROR
q is missing, start is not a multiple of 30, or a value is malformed. The request is not charged.
HTTP UPSTREAM_UNAVAILABLE
DuckDuckGo is temporarily unavailable or found no news. The request is not charged. Retry shortly.
Generate Code with AI
Copy a ready-made prompt with all the endpoint details, parameters, and example responses. Paste it into ChatGPT, Claude, or any AI assistant to instantly generate working code.
Try It Live
Test this endpoint in our interactive playground with real data.