​
Base URL

https://api.genx.zone

​
Authentication

GenX uses session-based authentication. All API requests (except auth endpoints) require a valid session cookie. Include credentials in your requests: 
curl -X GET https://api.genx.zone/api/bot-accounts \
  -H "Cookie: connect.sid=YOUR_SESSION_COOKIE"
Or with fetch: 
fetch('https://api.genx.zone/api/bot-accounts', {
  credentials: 'include'
})

​
Response Format

All responses return JSON: 
// Success
{
  "accounts": [...],
  "count": 10
}

// Error
{
  "error": "Unauthorized"
}

​
HTTP Status Codes

CodeDescription
200Success
201Created
400Bad request — invalid parameters
401Unauthorized — not logged in
403Forbidden — insufficient permissions
404Not found
500Server error

​
Rate Limiting

There are no hard rate limits on the API, but excessive requests may be throttled. The Twitter API integration (twitterapi.io) has its own rate limits.

​
Conventions

  • All timestamps are ISO 8601 format
  • Request bodies are JSON (Content-Type: application/json)
  • Array fields (keywords, tags, etc.) are stored as JSONB
  • IDs are prefixed strings (e.g., user-abc123, acc-def456, camp-ghi789)