List Newsfeeds
GET
/v1/newsfeeds
Returns all newsfeeds owned by or shared with the authenticated user.
Request
No parameters required.curl https://twixb.com/api/v1/newsfeeds \
-H "X-API-Key: twxb_your_key_here"
Response
[
{
"id": "28b37688-8549-446b-a2f2-9fb49ed51ae7",
"user_id": "ff670e33-6e73-4845-8585-80a0c8920517",
"name": "AI Research",
"description": "Latest AI papers and news",
"keywords": ["LLM", "transformer", "machine learning"],
"start_date": "2026-01-09",
"business_context": null,
"digest_frequency": "weekly",
"created_at": "2026-02-08T20:16:42.060322",
"updated_at": "2026-02-09T09:24:10.421330",
"source_count": 3,
"unread_count": 42,
"role": "owner"
}
]
Response fields
| Field | Type | Description |
|---|---|---|
id | string (UUID) | Newsfeed ID |
name | string | Newsfeed name |
description | string | Optional description |
keywords | string[] | Keywords used to filter incoming posts |
start_date | string | Only posts after this date are included |
business_context | string | Context used to personalize AI key learnings |
digest_frequency | string | Email digest frequency (daily or weekly) |
source_count | integer | Number of sources in this newsfeed |
unread_count | integer | Number of unread posts |
role | string | Your role (owner or editor) |