> ## Documentation Index
> Fetch the complete documentation index at: https://docs.twixb.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List Posts

> List and filter posts in a newsfeed.

# List Posts

<div className="method-badge get">GET</div> `/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`) |

```bash theme={null}
# 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

```json theme={null}
[
  {
    "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             |