News
The News connector exposes one endpoint:
| Endpoint | Purpose | Billed |
|---|---|---|
GET /v1/news/search | Keyword discovery across news publishers | per page |
Run a keyword search to discover relevant articles; each result includes the article headline, a link to the article on the publisher's site, and a short snippet.
Recency windows
Narrow results to a time window with the optional time_filter parameter:
time_filter | Meaning |
|---|---|
| (empty) | No time restriction (default) |
day | Last 24 hours |
week | Last 7 days |
month | Last 30 days |
year | Last 12 months |
Latency & reliability
News is a public-web source, so:
- Results are best-effort discovery — they reflect what is publicly available and can shift over time; they are not exhaustive.
- Occasional
429 upstream_rate_limitedresponses indicate a transient block — retry with backoff and it will clear. See Errors. - Large
max_pagesvalues run several sequential fetches; prefer modest page counts and paginate over multiple calls for big pulls.