Mukoko News API

📰 News & Articles

GET /api/feeds

Get paginated news feed. Supports filtering by category.
Query params: limit, offset, category

Try it →

GET /api/categories

Get all available news categories (Politics, Economy, Sports, etc.)

Try it →

GET /api/article/by-source-slug

Get single article by source and slug.
Query params: source, slug

💚 User Engagement

POST /api/articles/:id/like

Like or unlike an article (requires authentication)

POST /api/articles/:id/save

Bookmark or unbookmark an article (requires authentication)

POST /api/articles/:id/view

Track article view for analytics

GET /api/articles/:id/comments

Get comments for an article

POST /api/articles/:id/comment

Add a comment to an article (requires authentication)

🔐 Authentication

POST /api/auth/login

Login with email and password. Returns session token.

POST /api/auth/register

Register new user account. Creates session automatically.

POST /api/auth/logout

Logout and invalidate session token.

GET /api/auth/session

Get current session and user info.

👤 User Profile

GET /api/user/me/preferences

Get user preferences and settings (requires authentication)

POST /api/user/me/preferences

Update user preferences (requires authentication)

POST /api/user/me/follows

Follow a news source or journalist (requires authentication)

GET /api/health

Health check endpoint. Returns service status.

Try it →

🤖 AI Testing

POST /api/admin/ai-test

Run AI functionality tests. Tests: AI binding, inference, content cleaning, keyword extraction, and quality scoring.

GET /api/admin/ai-pipeline-status

View AI processing statistics, author recognition, and keyword extraction metrics.

View Status →

GET /api/admin/content-quality

View content quality distribution and AI enhancement statistics.

View Quality →