diff --git a/docs/README.md b/docs/README.md
index bdbd26e..0224cc9 100644
--- a/docs/README.md
+++ b/docs/README.md
@@ -265,17 +265,30 @@ Our implementation includes:
 
 ## 🔌 API Endpoints
 
-### All 10 API Endpoints
-* `GET /` - API health check
-* `GET /health` - Detailed system status
+### All 13 API Endpoints
+
+#### **Core System (3)**
+* `GET /` - API health check and version info
+* `GET /health` - Detailed system status and vector store metrics
+* `GET /stats` - Comprehensive system statistics and performance data
+
+#### **News Management (2)**
 * `POST /fetch-news` - Fetch latest news from all RSS sources
-* `GET /recommend-news` - Get recommendations by article ID
+* `GET /articles?limit=N&offset=M` - Get articles with pagination and advanced filtering
+
+#### **Recommendations (4)**
+* `GET /recommend-news?article_id=X&top_k=N` - Get recommendations by article ID
 * `POST /recommend-by-query` - Get recommendations based on text query
 * `POST /recommend-by-interests` - Get recommendations by user interests
-* `GET /trending?top_k=N` - Get N most recent articles
-* `GET /articles?limit=N` - Get N articles from database with filtering
-* `POST /search` - Advanced search with multiple filters
-* `GET /stats` - System statistics and metrics
+* `GET /trending?top_k=N` - Get N most trending articles
+
+#### **Search & Discovery (1)**
+* `POST /search` - Advanced semantic search with multiple filters
+
+#### **AI Analysis (3)**
+* `POST /analyze-article` - AI-powered article analysis (summary, sentiment, keywords)
+* `POST /generate-insights` - Generate AI insights from multiple articles
+* `GET /ai-status` - Check AI system status and capabilities
 
 ### Example Responses