Skip to content
Live demo

GET /discover

Find RSS feeds the workspace does not have yet. Give a topic to search a curated catalogue of quality sources, or a url to scan a specific site for its feeds. Returns sample headlines so the user can judge a source before subscribing, and marks anything already subscribed. Use this before add_feed.

GET/discover
Runs against the demo workspace
ParameterTypeRequiredDescription
topicstringnoWhat to look for, e.g. “climate tech”.
urlstringnoA site to scan, e.g. “https://theverge.com”.
limitintegernoDefault 8, max 20.
StatusMeaning
200Find feeds
400Invalid or missing parameters.
401Missing or invalid API key.
403The key lacks the “workspace:read” scope.
429Rate limit exceeded. See Retry-After.

Requires the workspace:read scope.