Predictable when something goes wrong.

Errors use HTTP status codes plus a compact JSON error object. Rate-limit information is returned in headers on API responses.

{
  "error": {
    "code": "video_not_found",
    "message": "Video not found."
  }
}

Rate-limit headers

Normal anonymous clients receive 120 requests/minute per client. LarpTube.com browser traffic uses its dedicated lane. HTTP 429 indicates the caller should wait for the window to reset.

Common errors