API Documentation
Integrate our high-performance IPTV validation engine into your own applications and workflows.
https://iptv.tutoje.cz/api
Authentication
Premium Feature
API access requires an active Premium membership.
All API requests must be authenticated using a specialized API key. This key should be passed in the request headers.
Required Header
X-API-Key: YOUR_TOKEN_HERE
Security Warning
Never expose your API key in client-side code (JavaScript). Always route API requests through a secure back-end server.
/subscriptions
Retrieve a collection of validated IPTV subscriptions with advanced filtering and sorting capabilities.
Query Parameters
hide_adult
Boolean
Set to '1' to filter out resources containing explicit adult categories.
sort
String
Field to order results by (e.g., id, server, created_at, exp_date).
Response Object
[
{
"id": 1,
"hash": "8f3e...",
"server": "http://provider.com",
"username": "user_45",
"exp_date": 1741171200,
"connections": 1,
"max_connections": 5
}
]/subscription/add
Provision and validate a new IPTV subscription in the global database.
Request Payload
{
"api_type": "xtream",
"server": "http://portal.url",
"username": "client_88",
"password": "secret_password"
}/subscription/bulk-add
Provision multiple subscriptions in a single request (Max 10 per request).
Request Payload
[
{
"api_type": "xtream",
"server": "http://portal1.url",
"username": "user1",
"password": "pass1"
},
{
"api_type": "stalker",
"server": "http://portal2.url",
"mac": "00:1A:79:..."
}
]/stats
Retrieve global database and donation statistics.
Response Object
{
"subscriptions": 1250,
"api_keys": 45,
"donations": 12,
"total_amount": 450.50,
"monthly_amount": 85.00,
"monthly_goal": 100.00
}/subscription/{hash}
Retrieve full details for a specific subscription by its hash.
Error Handling
The API uses standard HTTP response codes to indicate the success or failure of an API request.
Unauthorized
Invalid or missing API key in headers.
Rate Limit Exceeded
Maximum request threshold reached.
API Playground
Experiment with our endpoints in real-time. Results will be displayed directly below.
Support the Project
Help us maintain our servers and keep the development active. Every contribution counts!
€34.02 Collected This Month