API reference
All endpoints live at https://api.vroxify.com/api/v1. Use HTTPS and JSON responses.
Required headers
Acceptapplication/jsonRequiredContent-Typeapplication/json — POST/PUT requestsOptionalX-Platformvroxify — Identifies Vroxify clientsRequiredAuthorizationBearer <token> — User-scoped endpointsOptionalQuick start
curl -s "https://api.vroxify.com/api/v1/vroxify/catalog/home" \ -H "Accept: application/json" \ -H "X-Platform: vroxify"
Catalog & series
Home rails, series metadata, episodes, and playback.
| Method | Path | Auth | Description |
|---|---|---|---|
| GET | /vroxify/catalog/home | — | Homepage rails and featured content |
| GET | /vroxify/catalog/trending | — | Trending catalog items |
| GET | /vroxify/catalog/ranking | — | Ranked series and creators |
| GET | /vroxify/catalog/calendar | — | Release calendar |
| GET | /vroxify/series?page=1 | — | Paginated series list |
| GET | /vroxify/series/{id} | — | Series detail |
| GET | /vroxify/series/{id}/episodes | — | Episodes for a series |
| GET | /vroxify/series/{id}/watch | — | Watch page payload |
| GET | /vroxify/episodes/{id}/stream | — | Signed stream URL |
Authentication
Login, registration, and session tokens (Sanctum).
| Method | Path | Auth | Description |
|---|---|---|---|
| POST | /auth/login | — | Body: { login, password } |
| POST | /auth/register | — | Create account |
| POST | /auth/google | — | Body: { id_token } |
| GET | /auth/me | Bearer | Current user profile |
| POST | /auth/logout | Bearer | Invalidate token |
Videos & feed
Short-form UGC feed, likes, comments, and views.
| Method | Path | Auth | Description |
|---|---|---|---|
| GET | /videos/feed?page=1 | — | For You feed |
| GET | /videos/following?page=1 | Bearer | Following feed |
| GET | /videos/{id} | — | Video detail |
| POST | /videos/{id}/like | Bearer | Toggle like |
| POST | /videos/{id}/view | — | Record view |
| GET | /videos/{id}/comments | — | Comment thread |
| POST | /videos/{id}/comments | Bearer | Post comment |
Live
Live streams, chat, and gifts.
| Method | Path | Auth | Description |
|---|---|---|---|
| GET | /live/streams | — | Active live rooms |
| GET | /live/{id} | — | Room detail |
| GET | /live/{id}/comments | — | Live chat history |
| POST | /live/{id}/comments | Bearer | Send chat message |
| POST | /live/{id}/gifts | Bearer | Send gift |
Advertising
Campaign delivery for partners (see ads.vroxify.com).
| Method | Path | Auth | Description |
|---|---|---|---|
| GET | /ads/feed | — | Eligible ads for placement |
| POST | /ads/{id}/impression | — | Track impression |
| POST | /ads/{id}/click | — | Track click |
| GET | /ads/mine | Bearer | Advertiser campaigns |
| POST | /ads | Bearer | Create campaign |