Skip to main content
TCW

DOCS

Technical documentation for the machine-readable layer.

📡 REST API

Public, read-only JSON API. No authentication required. Rate limited to 100 requests/hour per IP. All responses include CORS headers for cross-origin access.

Endpoints

GET/api/v1/articles?topic=&type=&limit=

List articles with optional filtering by topic cluster, article type, and pagination.

GET/api/v1/articles/:slug

Single article with full Concept DNA, key claims, predictions, and body content.

GET/api/v1/predictions?status=

All predictions with stats. Filter by status: pending, confirmed, busted, partially-confirmed.

Example

# List all articles about AI agents
curl https://thecontextwindow.com/api/v1/articles?topic=ai-agents

# Get a specific article with full Concept DNA
curl https://thecontextwindow.com/api/v1/articles/what-is-an-ai-agent

# Get all pending predictions
curl https://thecontextwindow.com/api/v1/predictions?status=pending

Response Format

{
  "articles": [
    {
      "title": "What Is an AI Agent?",
      "slug": "what-is-an-ai-agent",
      "articleType": "primer",
      "tldr": "An AI agent is a system that...",
      "publishedAt": "2026-03-10T10:00:00Z",
      "tags": ["agents", "definitions"],
      "topicCluster": { "name": "AI Agents", "slug": "ai-agents" }
    }
  ],
  "total": 6
}