API Documentation

Free, public API access to DailyDevLists content. Rate limited to 60 requests per minute per IP address.

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

Authentication

No authentication required. All endpoints are publicly accessible.

Rate Limiting

All endpoints are rate limited to prevent abuse:

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

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

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

Rate Limiting

All endpoints are rate limited to prevent abuse:

Limit: 60 requests per minute per IP address

Window: Rolling 60-second window

Response: HTTP 429 when limit exceeded

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

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