Channelziq API

Public endpoints available now. Full creator API coming in Phase 1.

v1.0

These are the currently available public endpoints. The full creator API — including scheduling, analytics, AI features, and platform integrations — is coming in Phase 1.

Base URL: https://channelziq.com/api/v1

Endpoints

GET /health

Platform health status. Returns current system status including database and cache connectivity.

Auth: None Rate Limit: 60 req/min
Response
{
  "success": true,
  "data": {
    "status": "ok",
    "timestamp": "2026-04-12T10:30:00.000Z",
    "uptime": 12345,
    "mysql": "connected",
    "redis": "connected"
  }
}
GET /waitlist/count

Returns the current total number of users on the waitlist.

Auth: None Rate Limit: 60 req/min
Response
{
  "success": true,
  "data": {
    "count": 142
  }
}
POST /subscribe

Join the Channelziq waitlist. Returns your position and a unique referral code.

Auth: None Rate Limit: 3 req/IP/hour
Request Body
{
  "email": "creator@example.com",
  "utm_source": "twitter",
  "referral_code": "abc123"
}
Response
{
  "success": true,
  "data": {
    "position": 143,
    "referral_code": "xyz789",
    "total_count": 143
  }
}
GET /roadmap

Returns the public roadmap with all planned, in-progress, and completed items.

Auth: None Rate Limit: 60 req/min
Response
{
  "success": true,
  "data": [
    {
      "id": 1,
      "title": "YouTube Connection",
      "status": "planned",
      "upvote_count": 42
    }
  ]
}
POST /roadmap/vote

Upvote a roadmap item. Each email can only vote once per item.

Auth: None Rate Limit: 10 req/IP/hour
Request Body
{
  "roadmap_item_id": 1,
  "email": "creator@example.com"
}
Response
{
  "success": true,
  "data": {
    "upvote_count": 43
  }
}
POST /feedback

Submit feedback, feature requests, or bug reports.

Auth: None Rate Limit: 5 req/IP/hour
Request Body
{
  "type": "feature",
  "subject": "Calendar view",
  "message": "Would love a content calendar"
}
Response
{
  "success": true,
  "data": {
    "feedback_id": 1
  }
}
GET /changelog

Returns all public changelog entries, newest first.

Auth: None Rate Limit: 60 req/min
Response
{
  "success": true,
  "data": [
    {
      "title": "Launch",
      "type": "info",
      "message": "Platform launched"
    }
  ]
}
GET /waitlist/position/:referral_code

Look up your waitlist position and referral stats using your unique referral code.

Auth: None Rate Limit: 30 req/min
Response
{
  "success": true,
  "data": {
    "position": 42,
    "referrals_made": 3,
    "total_count": 143
  }
}

Error Codes

Code Status Description
400 Bad Request Invalid input or missing required fields
401 Unauthorized Missing or invalid authentication token
404 Not Found The requested resource was not found
429 Too Many Requests Rate limit exceeded. Slow down and retry after the reset window.
500 Internal Server Error Something went wrong on our end. Try again later.

Rate Limits

Rate limits are enforced per IP address. Exceeding limits returns a 429 Too Many Requests response.

All responses include standard rate limit headers: X-RateLimit-Limit, X-RateLimit-Remaining, and X-RateLimit-Reset.

For API support, contact developers@channelziq.com