Topics and Feeds
Reference for the News Signal Feed topic catalog and identifiers
Y2 currently defines 40 News feeds in a shared source registry. The app and API use the IDs on this page to select topic caches.
The feed catalog is configuration-driven. Use GET /api/v1/news/feeds when an integration
needs to discover the current list at runtime instead of storing a copy.
Feed catalog
Every topic in the current registry uses a 12-hour recap window.
Select feeds in the app
Open News
Go to News and find Global Signal Feeds.
Toggle topic chips
Select a chip to add that feed. Select it again to remove it. You can combine topics from any group.
Allow the preference to save
Feed changes are saved after a one-second debounce. The app restores the saved selection on later visits.
The dashboard does not apply the API's default topic list to your saved preferences. If no feeds are selected, choose at least one chip before the Live Feed or Recap view can load data.
Choose a useful combination
Start narrow, then add broader feeds only when they contribute different coverage.
Market and policy
macro, equities, rates_fx, geopolitics
Technology supply chain
ai, semiconductors, critical_minerals, energy
Cyber risk
cyber, defense, telecom, geopolitics
Digital assets
crypto, bitcoin, ethereum, defi
Broad and narrow topics can overlap. For example, crypto can include events also found under
bitcoin or ethereum. More feeds increase coverage and can also increase duplicate context.
Use topic IDs with the API
Pass a comma-separated list to the topics query parameter:
curl "https://api.y2.dev/api/v1/news?topics=geopolitics,macro,energy&limit=50" \
-H "Authorization: Bearer y2_your_api_key"If topics is omitted, the API currently uses:
crypto, geopolitics, macro, equities, ai, energyUnknown topic IDs return 400 Bad Request.
Discover feeds dynamically
curl "https://api.y2.dev/api/v1/news/feeds" \
-H "Authorization: Bearer y2_your_api_key"Each feed entry includes its id, display names, description, group metadata, UI color, and
ontology-ingestion flag. Response metadata includes the catalog count and API default topics.
See the generated List feeds reference for the canonical response schema and authentication options.