Skip to main content

List Posts

GET
/v1/posts/newsfeed/{newsfeed_id}
Returns paginated posts from a newsfeed, with optional filters.

Path parameters

ParameterTypeDescription
newsfeed_idstring (UUID)Newsfeed ID

Query parameters

ParameterTypeDefaultDescription
pageinteger1Page number
limitinteger20Posts per page (max 100)
daysintegerOnly posts from the last N days
readbooleanFilter by read status (true or false)
# Get unread posts from the last 7 days
curl "https://twixb.com/api/v1/posts/newsfeed/f296206d-...?days=7&read=false&limit=10" \
  -H "X-API-Key: twxb_your_key_here"

Response

[
  {
    "id": "a6afb505-640c-4daf-a27d-d9b6b1eb2a83",
    "source_id": "95c6ced2-2e14-4dbd-8023-a2d4b63cbe55",
    "external_url": "https://arxiv.org/abs/2603.09987",
    "title": "Evolving Demonstration Optimization for Chain-of-Thought Feature Transformation",
    "summary": "The paper proposes a framework that enhances feature transformation in AI...",
    "keylearning": "The key insight is the proposed framework that enhances LLM-driven Feature Transformation...",
    "is_read": false,
    "published_at": "2026-03-12T04:00:00",
    "discovered_at": "2026-03-12T14:11:49.318570",
    "source_name": "rss.arxiv.org"
  }
]

Response fields

FieldTypeDescription
idstring (UUID)Post ID
source_idstring (UUID)Source this post came from
external_urlstringLink to original article
titlestringPost title
summarystringAI-generated summary
keylearningstringPersonalized key learning
is_readbooleanRead status
published_atstringOriginal publish date
discovered_atstringWhen twixb discovered this post
source_namestringSource display name