API Reference

Resolves movie or TV show stream links using a TMDB numerical ID or a text query. Behind the scenes, the endpoint cleans titles, queries content catalog providers (Netflix, Prime Video, Disney+, Hotstar), bypasses verify checks, resolves the HLS master playlist, and aggregates direct, proxied, and progressive download endpoints.

# Request Modern Family S1E1 resolution
curl -X GET "http://localhost:3000/api/resolve?id=Modern%20Family&type=tv&season=1&episode=1"

const url = 'http://localhost:3000/api/resolve?id=Modern%20Family&type=tv&season=1&episode=1';

fetch(url)
  .then(res => res.json())
  .then(data => {
    console.log('Proxied Stream URL:', data.proxied_url);
    console.log('Direct Download Link:', data.download_url);
    console.log('Stream Qualities:', data.stream_qualities);
    console.log('Download Qualities:', data.download_qualities);
  })
  .catch(err => console.error('Failed to resolve:', err));

import axios from 'axios';

const res = await axios.get('http://localhost:3000/api/resolve', {
  params: {
    id: 'Modern Family',
    type: 'tv',
    season: 1,
    episode: 1
  }
});

console.log('Direct Stream:', res.data.stream_url);
console.log('Proxied Stream:', res.data.proxied_url);
console.log('Stream Qualities:', res.data.stream_qualities);
console.log('Download Qualities:', res.data.download_qualities);

Intercepts HLS streams (`.m3u8` playlists, decryption keys, subtitle listings, and segment files) and rewrites relative/absolute paths into absolute proxy routes. It attaches required `Referer` headers and bypasses CORS sandboxing, guaranteeing standard HLS players (like `Hls.js` or `Video.js`) can play restricted streams.

import Hls from 'hls.js';

const video = document.getElementById('video-player');
const hls = new Hls();

// Play the local proxied playlist with rewritten CORS links
const proxiedUrl = "http://localhost:3000/api/stream-proxy?url=https%3A%2F%2Ftv.imgcdn.kim%2Fnewtv%2Fhls%2Fhs%2F1770001008.m3u8&referer=https%3A%2F%2Fnet52.cc";

hls.loadSource(proxiedUrl);
hls.attachMedia(video);
hls.on(Hls.Events.MANIFEST_PARSED, () => video.play());

<!-- Native HLS player for iOS Safari and macOS -->
<video 
  src="http://localhost:3000/api/stream-proxy?url=https%3A%2F%2Ftv.imgcdn.kim%2Fnewtv%2Fhls%2Fhs%2F1770001008.m3u8&referer=https%3A%2F%2Fnet52.cc" 
  controls 
  autoplay>
</video>

Direct progressive downloader. It parses the unencrypted HLS sub-playlist, downloads all MPEG-TS or JPEG segment chunks sequentially, handles backpressure, and pipes the combined stream directly to the response as a single continuous `.ts` file download (using the video/mp2t MIME type). Perfect for background download managers on mobile devices.

// Start background download using native Android DownloadManager
String downloadUrl = "http://localhost:3000/api/download?url=...";

DownloadManager.Request request = new DownloadManager.Request(Uri.parse(downloadUrl));
request.setTitle("Modern_Family.ts");
request.setMimeType("video/mp2t");
request.setNotificationVisibility(DownloadManager.Request.VISIBILITY_VISIBLE_NOTIFY_COMPLETED);
request.setDestinationInExternalPublicDir(Environment.DIRECTORY_DOWNLOADS, "Modern_Family.ts");

DownloadManager manager = (DownloadManager) getSystemService(Context.DOWNLOAD_SERVICE);
manager.enqueue(request);

# Direct progressive download download of the entire TS stream to file
curl -L -o "Modern_Family.ts" "http://localhost:3000/api/download?url=https%3A%2F%2Ftv.imgcdn.kim%2Fnewtv%2Fhls%2Fhs%2F1770001008.m3u8&referer=https%3A%2F%2Fnet52.cc&title=Modern_Family"

Diagnostic endpoint to test and monitor the reachability, response latency, and Cloudflare block status of the streaming providers (Vidlink and NHDAPI) directly from the current hosting server IP. Returns a real-time status summary of all sources.

# Trigger diagnostic self-test
curl -X GET "http://localhost:3000/api/test-providers"

const url = 'http://localhost:3000/api/test-providers';
 
fetch(url)
  .then(res => res.json())
  .then(data => {
    console.log('Vidlink status:', data.vidlink.status);
    console.log('NHDAPI status:', data.nhdapi.status);
  })
  .catch(err => console.error('Test failed:', err));