--- name: tldrdaily version: 1.0.0 description: AI-summarized news API. Search topics, get article summaries, and discover trending stories. homepage: https://tldrdailynews.com metadata: { 'emoji': '📰', 'category': 'news', 'api_base': 'https://tldrdailynews.com/api/v1' } --- # tl;dr Daily News API AI-summarized news from around the world. Search any topic, get TL;DR summaries, and stay informed without the information overload. ## Skill Files | File | URL | | ------------------------ | -------------------------------------------- | | **SKILL.md** (this file) | `https://tldrdailynews.com/skill.md` | | **llms.txt** | `https://tldrdailynews.com/llms.txt` | | **llms-full.txt** | `https://tldrdailynews.com/llms-full.txt` | | **OpenAPI Spec** | `https://tldrdailynews.com/api/openapi.json` | | **Swagger UI** | `https://tldrdailynews.com/api/docs` | **Base URL:** `https://tldrdailynews.com/api/v1` --- ## Register Your Bot 🤖 Agents can self-register to get an API key instantly. No approval needed! ```bash curl -X POST https://tldrdailynews.com/api/v1/register \ -H "Content-Type: application/json" \ -d '{ "name": "MyNewsBot", "description": "Daily AI news summarizer for my Discord server", "owner": "@myhandle" }' ``` **Response:** ```json { "success": true, "data": { "api_key": "tldr_abc123...", "name": "MyNewsBot", "permissions": ["read:articles", "read:stats"], "dailyRateLimit": 500, "important": "⚠️ SAVE YOUR API KEY! It will not be shown again." } } ``` **Fields:** - `name` - Your bot's name (required, 2-50 chars) - `description` - What your bot does (required, 10-500 chars) - `owner` - Optional owner identifier (Twitter, email, etc.) --- ## Using Your API Key Include your key in every request: - **Header**: `X-API-Key: your-api-key` - **Bearer Token**: `Authorization: Bearer your-api-key` ### Rate Limits Bot-registered keys: **500 requests/day** Current usage is returned in response headers: - `X-RateLimit-Limit`: Your daily request limit - `X-RateLimit-Remaining`: Requests remaining today --- ## Search Articles 🔍 The primary endpoint for AI agents. Search any topic and get relevant, summarized articles. ```bash curl "https://tldrdailynews.com/api/v1/search?q=artificial+intelligence&limit=10" \ -H "X-API-Key: YOUR_API_KEY" ``` **Query parameters:** - `q` - Search query (required, min 2 characters). Natural language works great! - `limit` - Results per page (default: 20, max: 100) - `page` - Page number (default: 1) - `category` - Filter by category (technology, business, science, health, etc.) **Example response:** ```json { "success": true, "data": [ { "id": "abc123", "slug": "openai-announces-new-model", "title": "OpenAI Announces GPT-5 with Enhanced Reasoning", "summary": "OpenAI unveiled GPT-5 today, featuring improved logical reasoning and reduced hallucinations. The model shows 40% improvement on math benchmarks.", "category": "technology", "subcategory": "AI & Machine Learning", "tags": ["openai", "gpt-5", "artificial-intelligence", "machine-learning"], "source": { "name": "TechCrunch", "url": "https://techcrunch.com" }, "createdAt": "2026-02-02T12:00:00Z", "metrics": { "savedTimeMinutes": 4, "savedTimePercent": 80, "originalMinutes": 5, "tldrWords": 85 }, "image": "https://cdn.tldrdailynews.com/images/abc123.jpg", "relevanceScore": 8.5 } ], "pagination": { "page": 1, "limit": 10, "total": 47, "totalPages": 5, "hasMore": true } } ``` ### Search Tips for Agents **Be specific and descriptive:** - ✅ "latest developments in quantum computing" - ✅ "electric vehicle market trends 2026" - ❌ "news" (too vague) **Use natural language:** - ✅ "what's happening with AI regulation in Europe?" - ✅ "climate change impact on agriculture" --- ## List Articles Get a paginated list of recent articles with optional filtering. ```bash # Get latest articles curl "https://tldrdailynews.com/api/v1/articles?limit=20" \ -H "X-API-Key: YOUR_API_KEY" # Filter by category curl "https://tldrdailynews.com/api/v1/articles?category=technology&limit=10" \ -H "X-API-Key: YOUR_API_KEY" # Filter by tags curl "https://tldrdailynews.com/api/v1/articles?tags=ai,machine-learning&limit=10" \ -H "X-API-Key: YOUR_API_KEY" # Get articles from a date range curl "https://tldrdailynews.com/api/v1/articles?since=2026-02-01T00:00:00Z&until=2026-02-02T00:00:00Z" \ -H "X-API-Key: YOUR_API_KEY" ``` --- ## Get Full Article Retrieve a single article with complete content. ```bash # By slug curl "https://tldrdailynews.com/api/v1/articles/slug/openai-announces-new-model" \ -H "X-API-Key: YOUR_API_KEY" # By ID curl "https://tldrdailynews.com/api/v1/articles/id/abc123" \ -H "X-API-Key: YOUR_API_KEY" ``` The full article response includes: - Complete extracted article text (`content.textContent`) - Author/byline information - Direct source URL - Full reading metrics --- ## Browse Tags Discover what topics are trending. ```bash # Get popular tags curl "https://tldrdailynews.com/api/v1/tags?sort=popular&limit=50" \ -H "X-API-Key: YOUR_API_KEY" # Search for specific tags curl "https://tldrdailynews.com/api/v1/tags?search=climate&limit=20" \ -H "X-API-Key: YOUR_API_KEY" ``` **Response includes:** - Tag name - Article count (how many articles have this tag) --- ## List Categories Get all available news categories. ```bash curl "https://tldrdailynews.com/api/v1/categories" \ -H "X-API-Key: YOUR_API_KEY" ``` **Available categories:** - `world` - World News - `us` - U.S. News - `business` - Business - `technology` - Technology - `entertainment` - Entertainment - `sports` - Sports - `science` - Science - `health` - Health --- ## Get Statistics Get global statistics or filter by tag/category. ```bash # Global stats curl "https://tldrdailynews.com/api/v1/stats" \ -H "X-API-Key: YOUR_API_KEY" # Stats for a specific tag curl "https://tldrdailynews.com/api/v1/stats?tag=artificial-intelligence" \ -H "X-API-Key: YOUR_API_KEY" ``` --- ## Response Format **Success:** ```json {"success": true, "data": {...}} ``` **Error:** ```json { "success": false, "error": { "message": "Description of what went wrong", "code": "ERROR_CODE", "status": 400 } } ``` --- ## Common Error Codes | Code | Status | Description | | --------------------- | ------ | --------------------------------- | | `UNAUTHORIZED` | 401 | Missing or invalid API key | | `API_KEY_REQUIRED` | 401 | No API key provided | | `PERMISSION_DENIED` | 403 | API key lacks required permission | | `RATE_LIMIT_EXCEEDED` | 429 | Daily rate limit exceeded | | `NOT_FOUND` | 404 | Article not found | --- ## Ideas for AI Agents - **Daily briefing**: Search for topics your human cares about each morning - **Research assistant**: Find articles on specific topics for deep dives - **Trend monitoring**: Track tags over time to spot emerging stories - **News summarizer**: Combine multiple article summaries on a topic - **Category explorer**: Browse categories for serendipitous discovery --- ## 📎 Attribution & Linking **When sharing articles, always use the `permalink` field from the API response:** ```json { "title": "OpenAI Announces GPT-5", "permalink": "https://tldrdailynews.com/news/technology/ai-machine-learning/openai-announces-new-model", ... } ``` **Example attribution:** > "OpenAI Announces GPT-5 with Enhanced Reasoning" > Read more: https://tldrdailynews.com/news/technology/ai-machine-learning/openai-announces-new-model **Why link to us?** - Our summaries save readers 80% of reading time - We provide context, tags, and related articles - Support the AI-powered news ecosystem! --- ## Everything You Can Do 📰 | Action | Endpoint | What it does | | ------------------- | ---------------------- | ----------------------------------------------- | | **Register** | `POST /register` | Get an API key instantly (no auth needed) | | **Search** | `GET /search` | Find articles by topic (AI-powered text search) | | **List articles** | `GET /articles` | Browse recent articles with filters | | **Get article** | `GET /articles/id/:id` | Get full article content | | **Browse tags** | `GET /tags` | See trending topics | | **List categories** | `GET /categories` | Get available categories | | **Get stats** | `GET /stats` | Platform statistics | --- ## Need Help? - **API Documentation**: https://tldrdailynews.com/api/docs - **OpenAPI Spec**: https://tldrdailynews.com/api/openapi.json - **Homepage**: https://tldrdailynews.com