TV Home Watch TV About Subscription IPTV API

IPTV API Access

Clean IPTV URLs for Your Projects — $100/month

Integrate 30,000+ live TV channels into your own applications, media players, IPTV services, or streaming platforms. Our IPTV API delivers clean, validated, and regularly updated streaming URLs. Whether you're building a custom TV app, a media center, or a white-label IPTV service, our API gives you the data you need.

Get API Access — $100/mo View API Docs
30,000+ Streams

Clean, validated IPTV URLs updated daily. Always growing.

Clean URLs

All stream URLs are clean, validated, and ready to use.

Filter by Country & Type

Filter channels by country, category/type, or search by name.

Developer Support

Get integration help from our dev team via WhatsApp & tickets.

What is the IPTV API?

The UMVA TV IPTV API is a RESTful API that provides programmatic access to our entire library of 30,000+ live TV channels. Each API response includes the channel name, streaming URL, the channel type/category, country of origin, and thumbnail image.

Unlike the standard UMVA TV web interface (which costs only $2/month for end users), the IPTV API is designed for developers and businesses who want to integrate live TV channels into their own applications, media players, IPTV services, or white-label solutions.

All stream URLs returned by the API are clean, validated, and ready to use in your applications. Authentication is handled via API keys — one key per subscription.

Quick Facts
Price $100/month per API key
Auth Bearer Token (API Key)
Format JSON
Rate Limit 200 requests/minute
Streams Clean, validated URLs ready to use
Channels 30,000+ active channels

Simple, Transparent Pricing

What you see is what you pay. No discounts, no hidden fees, no surprises.

Full IPTV API Access
$100 /month

$1,200/year — flat rate, no discounts, no hidden fees.

  • Full REST API Access
  • 30,000+ Clean Streaming URLs
  • Filter by Country, Type & Search
  • JSON Responses — Easy Integration
  • Cancel Anytime — No Contracts
  • No Hidden Fees — What You See Is What You Pay
Get API Access — $100/mo

Visa, Mastercard, Amex, Crypto, Bank Transfer & Mobile Money accepted.

API Endpoints

Comprehensive REST API for accessing 30,000+ live TV channels. All endpoints return JSON.

Base URL
https://umva.net/api/iptv
Authentication

All API endpoints require authentication using your API key. You can provide it in two ways:

Header Authorization: Bearer {your_api_key}
Query Param https://umva.net/api/iptv/channels?api_key={your_api_key}

Your API key is generated automatically when you subscribe. Find it in your dashboard under IPTV API Settings.

GET /channels

Get a paginated list of TV channels with clean streaming URLs. Optionally filter by country, type, or search term.

Query Parameters (all optional):
Optional country Filter by country name (e.g. "United States")
Optional type Filter by channel type/category (e.g. "News")
Optional search Search by channel name
Optional per_page Results per page (default: 50, max: 200)

cURL Example:

curl -H "Authorization: Bearer iptv_your_api_key_here" \
  "https://umva.net/api/iptv/channels?country=United+States&type=News&per_page=10"
GET /countries

Get a list of all available countries that have channels in our database. Useful for building country filter dropdowns in your application.

cURL Example:

curl -H "Authorization: Bearer iptv_your_api_key_here" \
  "https://umva.net/api/iptv/countries"
GET /types

Get a list of all available channel types/categories. Useful for building type filter dropdowns in your application.

cURL Example:

curl -H "Authorization: Bearer iptv_your_api_key_here" \
  "https://umva.net/api/iptv/types"
GET /stream/{channel_id}

Get a stream URL for a specific channel. This endpoint validates your subscription and returns the streaming URL.

cURL Example:

curl -H "Authorization: Bearer iptv_your_api_key_here" \
  "https://umva.net/api/iptv/stream/{channel_id}"

Response Format

All API responses follow a consistent JSON structure.

Success Response (Channels List) 
{
  "success": true,
  "data": [
    {
      "channel_id": "uuid-here",
      "channel_name": "CNN International",
      "channel_url": "https://umva.net/api/iptv/stream/uuid-here?api_key=...",
      "channel_url_type": "m3u8",
      "channel_country": "United States",
      "channel_type": "News, Top News",
      "channel_thumb": "https://umva.net/assets/TV/us.png"
    }
  ],
  "meta": {
    "current_page": 1,
    "last_page": 10,
    "per_page": 50,
    "total": 500,
    "subscription_status": "active",
    "subscription_expires_at": "2025-12-31T23:59:59Z"
  }
}
Error Response (Unauthorized) 
{
  "success": false,
  "message": "Invalid API key."
}
Error Response (Expired Subscription) 
{
  "success": false,
  "message": "Subscription is expired. Please renew your subscription.",
  "status": "expired",
  "expires_at": "2025-01-01T00:00:00+00:00"
}

Integration Examples

Quick start guides for popular programming languages and use cases.

PHP (cURL) 
$apiKey = 'iptv_your_api_key_here';
$ch = curl_init('https://umva.net/api/iptv/channels?per_page=5');
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer ' . $apiKey
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
$data = json_decode($response, true);
foreach ($data['data'] as $channel) {
    echo $channel['channel_name'] . "\n";
    echo $channel['channel_url'] . "\n";
}
Python (requests) 
import requests

api_key = 'iptv_your_api_key_here'
headers = {'Authorization': f'Bearer {api_key}'}
params = {'per_page': 5}

response = requests.get(
    'https://umva.net/api/iptv/channels',
    headers=headers,
    params=params
)
data = response.json()
for channel in data['data']:
    print(channel['channel_name'])
    print(channel['channel_url'])
JavaScript (fetch) 
const apiKey = 'iptv_your_api_key_here';

fetch('https://umva.net/api/iptv/channels?per_page=5', {
    headers: {
        'Authorization': `Bearer ${apiKey}`
    }
})
.then(res => res.json())
.then(data => {
    data.data.forEach(channel => {
        console.log(channel.channel_name);
        console.log(channel.channel_url);
    });
});
VLC / M3U Playlist 
# Use the channels endpoint to generate an M3U playlist
# Programmatically fetch channels and generate:
#EXTM3U
#EXTINF:-1 tvg-id="" tvg-name="CNN International" tvg-logo="https://umva.net/assets/TV/us.png",CNN International
https://umva.net/api/iptv/stream/{id}?api_key=iptv_your_key
#EXTINF:-1 tvg-id="" tvg-name="BBC World News" tvg-logo="https://umva.net/assets/TV/gb.png",BBC World News
https://umva.net/api/iptv/stream/{id}?api_key=iptv_your_key

Who Uses the IPTV API?

Our API powers TV experiences for developers and businesses worldwide.

Custom TV Apps

Build your own live TV streaming application for mobile, desktop, or web. Use our API as the content source and build your own user interface and experience.

White-Label IPTV Services

Launch your own IPTV service using our API as the backend. Package our channels under your brand, set your own pricing, and manage your own customers.

Media Center Plugins

Create plugins for Kodi, Plex, Jellyfin, Emby, or other media center platforms. Give your users access to 30,000+ live TV channels directly from their media center.

Mobile Apps

Integrate live TV into your iOS or Android application. Our JSON API is easy to consume from any mobile framework including React Native, Flutter, and native SDKs.

Automation & Bots

Use our API in automation scripts, chatbots, or AI applications. Fetch channel lists, stream URLs, and metadata programmatically for any automation workflow.

Market Research & Monitoring

Monitor live TV channels from around the world for news analysis, media monitoring, competitive intelligence, or content research. Access channels from 200+ countries.

IPTV API FAQ

Common questions about the IPTV API subscription.

The $2/month subscription is for end users who want to watch TV channels through our web interface. The $100/month IPTV API is for developers and businesses who want programmatic access to channel data and streaming URLs to integrate into their own applications, media players, or white-label services.

After subscribing to the IPTV API plan, your API key is automatically generated. You can find it in your user dashboard under IPTV API Settings. The key format is "iptv_" followed by 40 random characters.

Yes! The IPTV API is designed for integration into any application. Our REST API returns JSON, making it compatible with iOS, Android, web apps, desktop apps, and any other platform that can make HTTP requests.

Yes. All channel URLs returned by the API are clean, validated, and ready to use directly in your applications, media players, or IPTV services. No additional processing needed — just fetch and play.

Channels are synced and validated daily. New channels are added continuously, and broken or inactive streams are removed. The total channel count is always growing.

We support HLS (.m3u8), MP4, and other common streaming formats. The channel_url_type field in the API response indicates the format for each channel. Most channels use HLS (m3u8).

Yes! Our API supports filtering by country name, channel type/category, and text search. Use the country, type, and search query parameters with the /channels endpoint. Use the /countries and /types endpoints to get the list of available filter values.

The API is rate-limited to 200 requests per minute per API key. If you need higher limits, contact our support team to discuss custom plans.

Yes, you can cancel anytime from your dashboard. Your API access will continue until the end of your current billing period. No early termination fees.

Our pricing is simple and transparent: $100/month or $1,200/year. What you see is what you pay — no discounts, no hidden fees, no surprises. One flat rate for full API access to all 30,000+ channels.

Ready to Integrate Global TV?

Get clean IPTV URLs for 30,000+ channels. $100/month. Start building today.

Get API Access — $100/mo
About UMVA TV

UMVA TV started operating in 2022, bringing live television from every country in the world to viewers everywhere. Today, we offer over 30,000 live TV channels from 200+ countries — the largest collection available anywhere. All for just $2/month.

Channel Categories
Popular Countries
Subscription & Pricing
IPTV API
Quick Links
Need Help?
WhatsApp Live Chat
30,000+ Live Channels 200+ Countries All Categories Only $2/month No Contract Cancel Anytime