API Documentation

v1.0.0 • Public Beta

Checking System Status...

Integrate real-time AI news directly into your applications. Our API provides structured access to the latest breakthroughs, tools, and industry updates from over 20+ verified sources.

Base URL

https://aiweb-brief.vercel.app/api/v1

Rate Limits

Public Access100 req/hour

Headers: X-RateLimit-Remaining, X-RateLimit-Reset

GET/news

List Articles

Fetch the latest AI news articles with filtering, sorting, and pagination support.

Parameters

Name	Type	Default	Description
limit	number	50	Max articles (1-100)
category	string	ALL	Filter by category ID (e.g. 'TOOLS')
source	string	-	Filter by source name substring
time	string	7d	Window: 24h, 7d, 30d, all
sort	string	rank	Sort: rank, heat, latest
search	string	-	Keyword search in title/summary

Fetch the 5 highest ranked tool-related articles from the last 7 days.

GET /news?category=TOOLS&limit=5&sort=rank

curl -X GET "https://aiweb-brief.vercel.app/api/v1/news?category=TOOLS&limit=5&sort=rank" \
  -H "Accept: application/json"

Response Preview

{
  "success": true,
  "data": [
    {
      "id": "abc-123",
      "title": "OpenAI Announces GPT-5",
      "summary": "The next generation model...",
      "category": "BREAKTHROUGHS",
      "publishedAt": "2026-02-08T10:00:00Z",
      "sourceName": "OpenAI Blog",
      "url": "https://openai.com/..."
    }
  ],
  "meta": {
    "count": 1,
    "limit": 50
  }
}

GET/categories

List Categories

Get all available news categories with their display metadata.

GET/sources

List Sources

Get the list of all tracked RSS feeds and their reliability tiers.

GET/status

System Status

Check API health and current version.

POST/refresh

Refresh Cache

Manually trigger a background fetch to update the news cache. Requires API key.

Parameters

Name	Type	Default	Description
x-api-key	header	-	Admin key (default: 'admin')

Trigger a fresh fetch of all RSS feeds immediately.

GET /refresh

curl -X POST "https://aiweb-brief.vercel.app/api/v1/refresh" \
  -H "Accept: application/json" \
  -H "x-api-key: admin"

Response Preview

{
  "success": true,
  "data": {
    "message": "Cache refreshed successfully",
    "totalArticles": 142
  },
  "meta": {
    "timestamp": "2026-02-08T10:00:00Z"
  }
}

Internal Debug Tools

These endpoints are for administrative use and providing programmatic access to raw database state.

GET/debug/articles

Raw Article Data

Fetch the raw Convex objects for the latest 300 articles. No filtering or transformation applied.

POST/debug/ingest

Trigger Manual Ingestion

Manually trigger the Convex RSS ingestion and AI analysis pipeline.