Developer API

Authentication

Pass your API key in the Authorization header:

curl https://vora.app/api/v1/videos \
  -H "Authorization: Bearer vora_live_••••••••"

List published public videos. Supports ?page, ?limit (max 50), ?tag (tag name, case-insensitive), ?authorId.

Example response:

{
  "data": [
    {
      "id": "cuid…",
      "title": "Neon cityscape at dusk",
      "likeCount": 142,
      "author": { "username": "creator42" },
      "tags": [{ "tag": { "name": "Cinematic" } }]
    }
  ],
  "pagination": { "page": 1, "limit": 20, "total": 840, "pages": 42 }
}

Rate Limits

Rate limits are enforced per API key using a sliding window. Responses include X-RateLimit-Remaining and X-RateLimit-Reset (Unix timestamp) headers. Exceeded limits return HTTP 429.

Error Codes