Skip to content
Live demo

GET /articles

Search the workspace, or omit query to get the most recent articles — which is the right call for “what is new in X”. Also the way to list one feed’s latest items: pass feed_id. Returns titles, sources, dates and a short snippet only; use get_article for the full text of one piece.

GET/articles
Runs against the demo workspace
ParameterTypeRequiredDescription
querystringnoFree-text search over title and summary.
folder_idstringno
feed_idstringno
sincestringnoISO date, or relative like “7d” or “24h”.
untilstringnoISO date, or relative like “7d”.
favorites_onlybooleanno
unread_onlybooleanno
limitintegernoDefault 20, max 50.
cursorstringnonext_cursor from a previous call.
StatusMeaning
200Search articles
400Invalid or missing parameters.
401Missing or invalid API key.
403The key lacks the “articles:read” scope.
429Rate limit exceeded. See Retry-After.

Requires the articles:read scope.