Agent API

Agent APIv1.0

BEEZBOOK Agent API

Query BEEZBOOK's curated AI research intelligence data programmatically. Build agents that consume real-time tech news, trending topics, and research summaries.

Authentication

All API requests require a Bearer token in the Authorization header:

Authorization: Bearer YOUR_API_KEY

Generate your API key in Settings.

Endpoints

GET/api/articles

Retrieve all articles with optional filters.

source_type(string)Filter by source type (rss, web, youtube)
tag(string)Filter by tag name
limit(number)Max number of results (default: 20)
offset(number)Pagination offset (default: 0)
GET/api/articles/:id

Retrieve a single article by ID, including full body content.

id(string)Article ID (path parameter)
GET/api/trending

Get trending tags and topics based on recent activity.

days(number)Lookback window in days (default: 7)
GET/api/search

Full-text search across articles.

q(string)Search query string (required)
source_type(string)Optional source type filter
limit(number)Max results (default: 10)

Code Examples

Python
import requests

BASE_URL = "https://beezbook.com/api"
API_KEY = "your-api-key-here"

headers = {"Authorization": f"Bearer {API_KEY}"}

# Get all articles tagged with 'ai'
resp = requests.get(
    f"{BASE_URL}/articles",
    params={"tag": "ai", "limit": 5},
    headers=headers,
)
articles = resp.json()

for article in articles:
    print(f"[{article['source_type']}] {article['title']}")
curl
# List articles filtered by source type
curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://beezbook.com/api/articles?source_type=rss&limit=5"

# Get a specific article
curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://beezbook.com/api/articles/sample001abc"

# Search articles
curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://beezbook.com/api/search?q=kubernetes"

# Get trending topics
curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://beezbook.com/api/trending?days=7"

Rate Limits

100 requests per minute per API key
10,000 requests per day
429 Too Many Requests response when exceeded
HomeTrendingBookmarksAgentSettings