> ## 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.

# Quickstart

> Get up and running with the twixb API in 5 minutes.

# Quickstart

This guide walks you through creating a newsfeed, adding a source, and reading your first AI-summarized posts.

## Prerequisites

* A twixb account at [twixb.com](https://twixb.com)
* An API key from [Settings](https://twixb.com/settings)

## 1. Create a newsfeed

```bash theme={null}
curl -X POST https://twixb.com/api/v1/newsfeeds \
  -H "X-API-Key: twxb_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "AI Research",
    "keywords": ["LLM", "transformer", "machine learning"],
    "description": "Latest AI research papers and news"
  }'
```

Response:

```json theme={null}
{
  "id": "abc123-...",
  "name": "AI Research",
  "keywords": ["LLM", "transformer", "machine learning"],
  "source_count": 0,
  "unread_count": 0
}
```

Save the `id` — you'll need it for the next steps.

## 2. Add a source

```bash theme={null}
curl -X POST https://twixb.com/api/v1/sources/{newsfeed_id} \
  -H "X-API-Key: twxb_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://openai.com/blog"}'
```

twixb auto-discovers RSS feeds and starts monitoring the source. Only posts matching your keywords will appear in the feed.

## 3. Read your posts

Posts appear after the next source check (within 24 hours, or sooner for active sources).

```bash theme={null}
curl https://twixb.com/api/v1/posts/newsfeed/{newsfeed_id}?limit=5 \
  -H "X-API-Key: twxb_your_key_here"
```

Each post includes:

* **title** — Original post title
* **summary** — AI-generated summary
* **keylearning** — Personalized insight based on your business context
* **external\_url** — Link to the original article

## 4. Get full post content

```bash theme={null}
curl https://twixb.com/api/v1/posts/{post_id} \
  -H "X-API-Key: twxb_your_key_here"
```

This returns the full post including `content_markdown`.

## Next steps

* [Add more source types](/api-reference/sources-add) (X/Twitter, Instagram, Reddit, TikTok)
* [Create reading lists](/api-reference/lists-create) to organize posts
* [Set up the MCP server](/guides/mcp) to use twixb from AI assistants