API Documentation
Integrate our high-performance IPTV validation engine and metadata indexes into your applications and automated workflows.
https://iptv.tutoje.cz/api
Authentication
Developer Access
API keys can be generated from the API Dashboard with an active Premium membership.
All API requests must be authenticated using a specialized API key. Pass your token in the request headers:
Required Header
X-API-Key: YOUR_API_TOKEN_HERE
Security Best Practice
Never expose your API key in client-side applications (SPA, mobile binaries, or browser scripts). Always route API requests through a secure server-side proxy.
/subscriptions
Retrieve a collection of validated IPTV subscriptions with filtering, sorting, and pagination options.
Query Parameters
hide_adult
Boolean
Set to '1' to filter out resources containing explicit adult channels or categories.
sort
String
Field to order results by (e.g. id, server, created_at, exp_date).
Example Response
[
{
"id": 1,
"hash": "8f3e...",
"server": "http://provider.com",
"username": "user_45",
"exp_date": 1741171200,
"connections": 1,
"max_connections": 5
}
]/subscription/add
Validate and save a new IPTV subscription line in the global catalog.
Request Payload
{
"api_type": "xtream",
"server": "http://portal.url",
"username": "client_88",
"password": "secret_password"
}/subscription/bulk-add
Validate multiple IPTV credentials in a single batch 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 scanner statistics, database metrics, and server target stats.
Example Response
{
"subscriptions": 1250,
"api_keys": 45,
"donations": 12,
"total_amount": 450.50,
"monthly_amount": 85.00,
"monthly_goal": 55.00
}/subscription/{hash}
Retrieve detailed scan results and live connection status for a specific subscription hash.
Error Handling
The API uses standard HTTP response codes to indicate request outcomes.
Unauthorized
Invalid or missing X-API-Key in headers.
Rate Limit Exceeded
Request threshold reached. Please reduce query frequency.
Bad Request
Missing required payload fields or malformed JSON body.
Not Found
The requested endpoint or subscription hash does not exist.
API Playground
Test and debug endpoints directly from the browser in real-time.
Support the Project
Help us maintain our servers and keep development active.
Monthly server target: €55.00
€35.00 Collected This Month