List Posts
GET
/v1/posts/newsfeed/{newsfeed_id}
Returns paginated posts from a newsfeed, with optional filters.
Path parameters
| Parameter | Type | Description |
|---|---|---|
newsfeed_id | string (UUID) | Newsfeed ID |
Query parameters
| Parameter | Type | Default | Description |
|---|---|---|---|
page | integer | 1 | Page number |
limit | integer | 20 | Posts per page (max 100) |
days | integer | — | Only posts from the last N days |
read | boolean | — | Filter 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
| Field | Type | Description |
|---|---|---|
id | string (UUID) | Post ID |
source_id | string (UUID) | Source this post came from |
external_url | string | Link to original article |
title | string | Post title |
summary | string | AI-generated summary |
keylearning | string | Personalized key learning |
is_read | boolean | Read status |
published_at | string | Original publish date |
discovered_at | string | When twixb discovered this post |
source_name | string | Source display name |