Articles
List articles
GET
Articles for a ticker, newest first: the filtered feed by default, or every ingested article with status=all.
apiKeyheader
AuthorizationBearer <token>cursor?stringOpaque cursor. Pass it back unchanged.
Length
1 <= lengthlimit?integerRange
1 <= value <= 200Default
50ticker*stringTicker symbol in capitals, such as ACME or BRK.B.
status?stringshortlisted (default): only articles kept by the filter. all: every article ingested for the ticker, with its pipeline_status.
Default
"shortlisted"Value in
"shortlisted""all"since?stringISO 8601 date and time, in UTC.
Format
date-timeA page of articles
application/json- response
data*array<>next_cursor*|Opaque cursor. Pass it back unchanged.
Length
1 <= lengthcurl -X GET 'https://api.newsfilter.dev/v1/articles?ticker=ACME'Example Response
{ "data": [ { "id": "art_01JC4ZQ8M6W7Y3T2K9P5R1N0BX", "title": "Acme raises full-year revenue guidance", "outlet": "Example Wire", "url": "https://news.example.com/acme-raises-guidance", "published_at": "2026-11-03T14:05:00Z", "ticker": "ACME", "site": "news.example.com", "teaser": "The company cited stronger orders from industrial customers.", "first_seen_at": "2026-11-03T14:05:00Z", "pipeline_status": "shortlisted", "judgement": { "shortlisted": true, "about_company": "primary", "article_type": "news", "new_fact": "Acme raised its full-year revenue guidance to $4.2 billion.", "fact_timing": "first_report", "criteria": [ "corporate_event" ], "reason": "First report of a guidance change from the company.", "judged_on": "body" }, "story_id": "st_01JC4ZQ8M6W7Y3T2K9P5R1N0BX" } ], "next_cursor": "string"}