API Documentation

Public API access to DailyDevLists content with optional authentication for enhanced limits. Search is available to everyone with tiered rate limiting.

Base URL: https://dailydevlists.com/api

✨ Search Available for Everyone: All search endpoints work without authentication, with 3x higher rate limits for authenticated users. Sign in to unlock enhanced features!

Authentication

The endpoints documented on this page do not require authentication. However, advanced features (search, analytics, trends API) require user authentication through our web interface.

Public Endpoints (No Auth Required)

• /api/health - System health check
• /api/feeds - List of content feeds
• /api/rss/* - RSS feed endpoints
• /api/recommendations - Content recommendations

Public with Enhanced Limits (Auth Optional)

• Search (keyword, semantic, hybrid) - Higher limits when authenticated

Anonymous users: Limited requests per minute. Sign in at dailydevlists.com for higher rate limits.

Protected Endpoints (Auth Required)

• Analytics and tracking APIs
• Weekly trends API
• Admin features

Create an account to access these features at dailydevlists.com

Rate Limiting

All endpoints are rate limited to prevent abuse. Limits vary by endpoint and authentication status:

Standard Endpoints

Public APIs: 60 requests per minute per IP address
Window: Rolling 60-second window
Response: HTTP 429 when limit exceeded

Search Endpoints (Tiered Limits)

Search is available to everyone, with higher limits for authenticated users:

Anonymous Users

• Keyword Search: 10/min
• Semantic Search: 3/min
• Hybrid Search: 5/min

Authenticated Users

• Keyword Search: 30/min
• Semantic Search: 10/min
• Hybrid Search: 15/min

💡 Tip: Sign in for 3x higher search limits and unlock additional features.

Rate Limit Headers

All responses include rate limit information in headers:

X-RateLimit-Limit: 60 - Maximum requests allowed

X-RateLimit-Remaining: 45 - Requests remaining in window

X-RateLimit-Reset: 1234567890 - Unix timestamp when limit resets

Retry-After: 30 - Seconds until you can retry (429 responses only)

Endpoints

GET/api/health

System health check endpoint. Returns database connectivity, PG listener status, and system metrics.

Response (200 OK)

{
  "status": "healthy",
  "timestamp": "2025-10-20T12:00:00.000Z",
  "version": "1.0.0",
  "buildSha": "abc123",
  "checks": {
    "database": {
      "status": "healthy",
      "latency": "15ms"
    },
    "pgListener": {
      "status": "active"
    }
  },
  "uptime": 3600.5,
  "environment": "production"
}

Response (503 Service Unavailable)

{
  "status": "unhealthy",
  "timestamp": "2025-10-20T12:00:00.000Z",
  "checks": {
    "database": {
      "status": "unhealthy",
      "error": "Connection refused"
    },
    "pgListener": {
      "status": "inactive"
    }
  }
}

Example Request

curl https://dailydevlists.com/api/health

GET/api/feeds

Returns a list of all visible content feeds (YouTube channels, topics, categories).

Response (200 OK)

[
  {
    "slug": "ai-engineering",
    "name": "AI Engineering",
    "category": "AI"
  },
  {
    "slug": "devops-sre",
    "name": "DevOps & SRE",
    "category": "DevOps"
  },
  {
    "slug": "react-frontend",
    "name": "React & Frontend",
    "category": "Frontend"
  }
]

Response Fields

slug - URL-friendly feed identifier
name - Human-readable feed name
category - Feed category (AI, DevOps, Frontend, Backend, Web3, Infrastructure)

Example Request

curl https://dailydevlists.com/api/feeds

GET/api/rss

Returns RSS feed with today's top 50 curated videos across all feeds.

Response Format

Standard RSS 2.0 XML format with video entries including title, description, publication date, category, and author information.

Additional RSS Endpoints

/api/rss/feed/[slug] - RSS feed for specific feed
/api/rss/category/[slug] - RSS feed for specific category

Example Request

curl https://dailydevlists.com/api/rss

GET/api/recommendations

Returns AI-powered content recommendations based on semantic similarity from transcript embeddings. Falls back to category-based recommendations when transcript embeddings are unavailable.

Query Parameters

itemId *required - The ID of the item to get recommendations for
limit - Maximum number of recommendations (default: 5, max: 20)
minSimilarity - Minimum similarity score 0-1 (default: 0.7)
category - Filter by category slug (optional)

Response (200 OK)

{
  "itemId": "123",
  "strategy": "content",
  "count": 5,
  "recommendations": [
    {
      "id": "456",
      "externalId": "dQw4w9WgXcQ",
      "title": "Advanced React Patterns",
      "similarity": 0.85,
      "category": {
        "name": "Frontend",
        "slug": "frontend"
      }
    }
  ],
  "metadata": {
    "limit": 5,
    "minSimilarity": 0.7
  }
}

Example Request

curl "https://dailydevlists.com/api/recommendations?itemId=123&limit=5"

Error Responses

429Too Many Requests

Returned when rate limit is exceeded. Wait for the time specified in Retry-After header.

{
  "error": "Too many requests",
  "message": "Rate limit exceeded. Please try again later.",
  "limit": 60,
  "reset": "2025-10-20T12:01:00.000Z"
}

500Internal Server Error

Returned when an unexpected error occurs. Retry after a short delay.

{
  "error": "Failed to fetch feeds"
}

Best Practices

Respect rate limits: Check X-RateLimit-Remaining header before making requests
Handle errors gracefully: Implement exponential backoff for 429/500 responses
Cache responses: Feed data changes daily at 7:30 AM UTC, cache accordingly
Set a User-Agent: Include your app name and contact email in the User-Agent header
Monitor your usage: Track rate limit headers to avoid hitting limits

Support & Feedback

Have questions or need help? We'd love to hear from you:

Email: support@dailydevlists.com

Terms of Use

By using the DailyDevLists API, you agree to our Terms of Service and Privacy Policy.

The API is provided "as is" without warranties. We reserve the right to modify or discontinue the API at any time.

Ready to Build?

Start integrating DailyDevLists into your application today.

Test Health Endpoint View Feeds