Skip to main content

​
Quickstart

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

​
Prerequisites

​
1. Create a newsfeed

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: 
{
  "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

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

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