Welcome
Welcome to the TeleLive developer docs — OAuth 2.1 apps and the Public API.
Base URLs
| Purpose | URL |
| Public API | `https://api.telelivee.ir/public/v1/…` (also `https://telelivee.ir/api/public/v1/…`) |
| OAuth | `https://api.telelivee.ir/oauth/authorize` · `https://api.telelivee.ir/oauth/token` |
| Discovery (no auth) | `GET /public/v1/` |
Responses are JSON: { "data": …, "message": "OK" }. Authenticate with Authorization: Bearer tloa_… from OAuth.
> The legacy personal token API (/api/developer.php with tl_dev_…) is retired. Create an App under Settings → Developer.
v1 resources
| Doc | Path |
| [Livestreams](/livestreams) | `GET /public/v1/livestreams` |
| [Categories](/categories) | `GET /public/v1/categories` |
| [Channels](/channels) | `GET /public/v1/channels` |
| [Users](/users) | `GET /public/v1/users` |
| [Chat](/chat) | `GET/POST /public/v1/chat`, `DELETE /public/v1/chat/{id}` |
| [Moderation](/moderation) | `GET …/moderators`, `POST/DELETE …/bans` |
| [Tele](/tele) | `GET /public/v1/tele` |
| [Channel Rewards](/channel-rewards) | `GET /public/v1/channels/rewards` (Spark) |
Start here
1. App Setup — create an app in Settings → Developer
2. OAuth 2.1 — authorize with PKCE
3. Scopes
Drops / ads-style products remain coming soon.