Skip to main content

​
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

FieldTypeDescription
idstring (UUID)Newsfeed ID
namestringNewsfeed name
descriptionstringOptional description
keywordsstring[]Keywords used to filter incoming posts
start_datestringOnly posts after this date are included
business_contextstringContext used to personalize AI key learnings
digest_frequencystringEmail digest frequency (daily or weekly)
source_countintegerNumber of sources in this newsfeed
unread_countintegerNumber of unread posts
rolestringYour role (owner or editor)