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) |
Response
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 |