BriefSum API

🔐 Authentication

Use an API key created in your Account page.

Authorization: Bearer bsk_xxxxxxxxxxxxxxxxxxxxxxxxxxxx
# or via query string (less secure):
GET /api/news/list?api_key=bsk_xxxxxxxx...&limit=20

Keys start with bsk_, are shown exactly once on create, and can be revoked at any time.

🧾 Plans & Access

Free guest — 5 requests/day on the site, no API access.
Pro / Pro+ / Enterprise API — unlimited usage + API access.

Compare plans →

📰 Content endpoints (free for all, rate-limited)

GET/api/news/list?page=1&limit=20&category=ai

GET/api/news/detail/{id}

GET/api/github-repos?page=1&language=python

GET/api/trending/topics

GET/api/trending/history

GET/api/feed/mixed?limit=40

GET/api/search/all?q=llama+4

👤 User endpoints (require API key + paid plan)

GET/api/user/quota

GET/api/user/favorites

POST/api/user/favorite { collect_type, target_id }

DEL/api/user/favorite?collect_type=news&target_id=42

GET/api/user/preferences

PUT/api/user/preferences { display_name, followed_topics, ... }

GET/api/user/usage-history?days=14

GET/api/keywords

PUT/api/keywords { keywords:[...], frequency:'daily' }

🔑 API key management

GET/api/user/api-keysPremium

POST/api/user/api-keys { name, scope:'read' }Premium

DEL/api/user/api-keys?id=123Premium

💡 cURL examples

# Fetch the latest AI news:
curl -H "Authorization: Bearer bsk_xxx" \
  https://briefsum.com/api/news/list?limit=10

# Save a news item to your favorites:
curl -X POST -H "Authorization: Bearer bsk_xxx" \
  -H "Content-Type: application/json" \
  -d '{"collect_type":"news","target_id":42}' \
  https://briefsum.com/api/user/favorite

# Check your plan + quota:
curl -H "Authorization: Bearer bsk_xxx" \
  https://briefsum.com/api/user/quota

📘 SDKs

There is no official SDK yet; just use fetch or any HTTP client with the Bearer header above.

Read the full API documentation · Subscribe for a key