Important
If this IPTV JSON database saved your time, please leave a GitHub Star.
Every ⭐ keeps this project alive.
Your support helps me:
- 📺 Add new channels
- 🔄 Update broken streams
- 🖼 Improve logos
- ⚡ Optimize JSON
- 🚀 Maintain this repository
A GitHub Star costs nothing but means everything. ❤️
IPTV JSON is a hand-curated, developer-friendly channel database converted from raw M3U playlists into clean, structured JSON — ready to drop into any IPTV player, web app, mobile app, or media project without extra parsing or cleanup.
No scraping. No automation. Every entry is manually verified, categorized, and formatted for reliability.
| Feature | Description |
|---|---|
| ⚡ Lightweight JSON | Minimal file size, maximum usability |
| 📺 IPTV Channel Collection | Hundreds of channels across dozens of categories |
| 🖼 Logo Support | Channel logos included as direct URLs |
| 🎬 M3U8 / HLS Streams | Standard HLS format, works everywhere |
| 📂 Organized Categories | Sports, News, Movies, Kids, and more |
| 📱 Mobile Friendly | Works seamlessly in Android and iOS apps |
| 🌐 Easy API Integration | One fetch call — that is all you need |
| 🚀 Fast Loading | No pagination, no auth, instant access |
| 🔄 Regular Updates | Channels, logos, and streams kept fresh |
| 🛠 Developer Friendly | Clean schema, consistent field names |
| 🆓 Completely Free | MIT licensed, use in any project |
| 🌍 Global Channels | Channels from multiple regions and languages |
Every channel entry follows this consistent schema:
{
"name": "Channel Name",
"logo": "https://example.com/logo.png",
"stream_url": "https://example.com/playlist.m3u8",
"category": "Sports"
}| Field | Type | Description |
|---|---|---|
name |
string |
Human-readable channel name |
logo |
string |
Direct URL to channel logo image |
stream_url |
string |
HLS / M3U8 stream URL |
category |
string |
Channel category for filtering |
Channels are organized into the following categories:
| 🏆 Sports | 📰 News | 🎬 Movies | 🎵 Music |
|---|---|---|---|
| 🧒 Kids | 🎮 Entertainment | 📚 Education | 🍳 Lifestyle |
| 🌍 International | 📺 General | 🏛 Government | ⛪ Religious |
| 🔬 Documentary | 🌤 Weather | 🛍 Shopping | 🎭 Culture |
More categories are added regularly. Open an issue to request a new one.
https://raw.githubusercontent.com/istiakrahman15/iptv-api/main/iptv.json
Fetch it, parse it, use it. No API key. No auth. No rate limits.
const IPTV_URL = 'https://raw.githubusercontent.com/istiakrahman15/iptv-api/main/iptv.json';
async function loadChannels() {
try {
const response = await fetch(IPTV_URL);
const channels = await response.json();
// Filter by category
const sports = channels.filter(ch => ch.category === 'Sports');
sports.forEach(channel => {
console.log(`📺 ${channel.name}`);
console.log(` 🔗 ${channel.stream_url}`);
console.log(` 🖼 ${channel.logo}`);
});
} catch (error) {
console.error('Failed to load channels:', error);
}
}
loadChannels();Play any stream directly in the browser using HLS.js:
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8" />
<title>IPTV Player</title>
<script src="https://cdn.jsdelivr.net/npm/hls.js@latest"></script>
</head>
<body>
<video id="player" controls width="800" autoplay></video>
<script>
const streamUrl = 'https://example.com/playlist.m3u8'; // from iptv.json
const video = document.getElementById('player');
if (Hls.isSupported()) {
const hls = new Hls();
hls.loadSource(streamUrl);
hls.attachMedia(video);
} else if (video.canPlayType('application/vnd.apple.mpegurl')) {
// Native HLS support (Safari / iOS)
video.src = streamUrl;
}
</script>
</body>
</html>iptv-api/
├── 📄 iptv.json ← Main channel database
├── 📝 README.md ← You are here
└── ⚖️ LICENSE ← MIT License
Follow these recommendations when integrating the JSON into your project:
✅ Cache the JSON locally — avoid fetching on every app launch
✅ Re-fetch periodically (daily / weekly) to get updated streams
✅ Validate stream URLs before presenting to users
✅ Handle offline mode gracefully with cached data
✅ Filter channels by category for a better UX
✅ Lazy-load logos to improve performance
✅ Use HLS.js for browser playback — native video tag will not play M3U8 everywhere
✅ Show fallback UI when a stream fails to load
| Metric | Status |
|---|---|
| ⭐ Stars |  |
| 🍴 Forks |  |
| 👀 Visitors | |
| 👁 Watchers |  |
| 📦 Repository Size |  |
| 📂 Categories | 8+ |
| 📺 Channels | 5,000+ |
| 🔄 Last Updated |  |
| 📝 License | MIT |
Does this repository host or broadcast streams?
No. This repository only stores references to streams — URLs that point to third-party servers. No video data is hosted here.
Can I use this in a commercial project?
The JSON database and code in this repository are MIT licensed. However, the legality of individual streams depends on your region and the content provider. You are solely responsible for ensuring your use complies with applicable laws.
How often is the database updated?
Updates are pushed regularly — broken links are removed, logos are improved, and new channels are added based on community feedback and availability.
Can I contribute channels?
Yes. See the Contributing section below. Contributions are welcome and reviewed manually.
Some streams are not working — what should I do?
Stream availability depends on the source server uptime. If a stream is consistently broken, please open an issue with the channel name so it can be reviewed or removed.
Is there an API endpoint for this data?
Yes — the raw GitHub URL acts as a free, public endpoint:
https://raw.githubusercontent.com/istiakrahman15/iptv-api/main/iptv.json
Contributions are welcome and appreciated. Please follow these guidelines to keep the database clean and consistent:
Before submitting:
- ✅ Verify the stream is publicly accessible
- ✅ Confirm the channel logo URL is a direct image link (
.png,.jpg,.svg) - ✅ Use the correct category from the supported list
- ✅ Ensure the channel name is spelled correctly
How to contribute:
- Fork this repository
- Add your channel entry to
iptv.jsonfollowing the exact schema - Test the stream URL before submitting
- Open a Pull Request with a clear description
Note: Entries with broken streams, incorrect categories, or missing logos will be rejected to maintain database quality.
Thousands of developers use IPTV JSON databases in their apps, media players, and streaming projects.
If this repository helped you, please give it a ⭐ Star to support future updates.
If this project adds value to your work, here are the best ways to show it:
| Action | Why it matters |
|---|---|
| ⭐ Star the repo | Shows appreciation, boosts visibility |
| 🍴 Fork it | Build your own version or contribute back |
| 🐞 Report broken streams | Keeps the database clean and reliable |
| 🚀 Share it | Help other developers discover the project |
| 🤝 Contribute | Add channels, fix logos, improve docs |
⭐ Star on GitHub · 🍴 Fork · 🐞 Report Issue
This repository is a community-maintained index of publicly available IPTV stream references. It does not host, store, distribute, or broadcast any media content.
- All stream URLs point to third-party servers outside the control of this repository.
- The repository owner makes no guarantees about stream availability, uptime, or content accuracy.
- Users are solely responsible for ensuring their use of any stream complies with local laws and regulations.
- This project is provided for educational and informational purposes only.
If you are a content owner and believe a stream listed here infringes your rights, please refer to the DMCA section below.
This repository contains only links to third-party content — no media files are stored or served here. As such, this repository is not a host of infringing content under the DMCA safe harbor provisions (17 U.S.C. § 512).
If you are a rights holder and believe a URL in this database links to infringing content:
- Open an issue with the subject "DMCA Takedown Request"
- Include the specific channel name and URL you wish to have removed
- Provide proof of ownership or authorization to act on behalf of the rights holder
Valid requests will be reviewed and acted upon promptly. We respect intellectual property rights and will remove any entries upon verified request.
MIT License
Copyright (c) 2024 Istiak Rahman
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
See the full LICENSE file for details.
If this repository helped you even once...
⭐ Star the repository
🍴 Fork it
🚀 Share it
🐞 Report broken streams
Note
No ⭐ Star • No ⛽ Fuel
Every Star motivates future updates — new channels, logo improvements, broken stream fixes, and continued maintenance.
⭐ Click here to Star this repository
