API Overview

A high-level overview of the OikosTV public API endpoints.

Base URL

https://dev.api.crewvid.com/api/v1/

Content & Discovery

Method	Endpoint	Description
GET	/videos/{shortUUID}	Fetch detailed information about a specific video
GET	/channels/{handle}	Retrieve channel details, including subscriber counts and metadata
GET	/videos/{shortUUID}/playback	Get playback bundle (manifest + session JWT) for a video

Monetization & Rewards

Method	Endpoint	Description
GET	/me/rewards/balance	Check your current PeerCredit balance
POST	/rewards/redeem	Exchange PeerCredits for ad-free viewing hours
GET	/studio/monetization/flags	View enabled monetization features for a channel

Authentication

All API requests must include a valid session token in the Authorization header:

Authorization: Bearer <session_token>

Rate limiting

To ensure platform stability, all public endpoints are subject to rate limiting. Please implement exponential backoff for retries.

Versioning

We use versioned URLs (e.g., /api/v1/...) to maintain backward compatibility as the API evolves. The current stable version is v1.

Error Responses

The API returns errors in a consistent format:

{
  "error": "Description of what went wrong"
}

Common HTTP status codes:

Code	Meaning
400	Bad Request — invalid parameters
401	Unauthorized — missing or invalid token
403	Forbidden — insufficient permissions
404	Not Found — resource doesn't exist
429	Too Many Requests — rate limit exceeded
500	Internal Server Error

---

SDK available

For easier integration, use the @crewvid/outpost-sdk package instead of calling the API directly.