Test a Source

curl --request GET \
  --url http://localhost:7860/api/test/{id} \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('http://localhost:7860/api/test/{id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_PORT => "7860",
  CURLOPT_URL => "http://localhost:7860/api/test/{id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "http://localhost:7860/api/test/{id}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("http://localhost:7860/api/test/{id}")

http = Net::HTTP.new(url.host, url.port)

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "source": "<string>",
  "id": "<string>",
  "s": {},
  "e": {},
  "ok": true,
  "url": {},
  "raw_url": {},
  "elapsed_ms": 123,
  "error": {}
}

GET

api

test

{id}

Test a Source

curl --request GET \
  --url http://localhost:7860/api/test/{id} \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('http://localhost:7860/api/test/{id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_PORT => "7860",
  CURLOPT_URL => "http://localhost:7860/api/test/{id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "http://localhost:7860/api/test/{id}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("http://localhost:7860/api/test/{id}")

http = Net::HTTP.new(url.host, url.port)

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "source": "<string>",
  "id": "<string>",
  "s": {},
  "e": {},
  "ok": true,
  "url": {},
  "raw_url": {},
  "elapsed_ms": 123,
  "error": {}
}

Tests one specific provider for a given TMDB ID without running the full parallel fanout. Useful for debugging why a source isn’t appearing in movie or TV responses, or for checking a provider’s availability before building.

This endpoint runs the same two-step verification pipeline as /movie and /tv — a HEAD check on the raw URL, followed by a proxied HLS playability check. The ok field reflects whether a verified, playable URL was found. HTTP status is always 200 regardless of source success or failure — always check ok in the body.

This endpoint requires a standard or partner API key, or a session token from POST /api/auth. The public key will receive a 403 response.

Path Parameters

string

required

TMDB ID. For movies, use the movie ID. For TV, use the series ID.

Query Parameters

string

required

Provider key to test. Must exactly match one of the configured source keys.Available keys are listed in the sources field of /api/health or via GET /api?sources_meta=1.

number

Season number. Required for TV episodes; omit for movies.

number

Episode number. Required for TV episodes; omit for movies.

Request

curl "http://localhost:7860/api/test/550?source=<provider-key>" \
  --header "Authorization: Bearer YOUR_API_KEY"

TOKEN=$(curl -s -X POST http://localhost:7860/api/auth | jq -r .token)

curl "http://localhost:7860/api/test/550?source=<provider-key>" \
  -H "X-Session-Token: $TOKEN"

curl "http://localhost:7860/api/test/1396?season=1&episode=1&source=<provider-key>" \
  --header "Authorization: Bearer YOUR_API_KEY"

TOKEN=$(curl -s -X POST http://localhost:7860/api/auth | jq -r .token)

curl "http://localhost:7860/api/test/1396?season=1&episode=1&source=<provider-key>" \
  -H "X-Session-Token: $TOKEN"

const { token } = await fetch(
  'http://localhost:7860/api/auth',
  { method: 'POST' }
).then(r => r.json());

const res = await fetch(
  'http://localhost:7860/api/test/550?source=<provider-key>',
  { headers: { 'X-Session-Token': token } }
);
const data = await res.json();

if (data.ok) {
  console.log(`✓ ${data.source} (${data.elapsed_ms}ms): ${data.url}`);
} else {
  console.error(`✗ ${data.source}: ${data.error}`);
}

interface TestResponse {
  source: string;
  id: string;
  s: number | null;
  e: number | null;
  ok: boolean;
  url: string | null;
  raw_url: string | null;
  elapsed_ms: number;
  error: string | null;
}

const { token } = await fetch(
  'http://localhost:7860/api/auth',
  { method: 'POST' }
).then(r => r.json());

const data: TestResponse = await fetch(
  'http://localhost:7860/api/test/550?source=<provider-key>',
  { headers: { 'X-Session-Token': token } }
).then(r => r.json());

import requests

res = requests.get(
  'http://localhost:7860/api/test/550',
  params={'source': '<provider-key>'},
  headers={
    'Authorization': 'Bearer your_standard_api_key'
  }
).json()

print(f"ok={res['ok']} elapsed={res['elapsed_ms']}ms")
if res['error']:
    print(f"error: {res['error']}")

Response

string

required

The provider key that was tested.

string

required

The TMDB ID that was tested.

number | null

required

Season number. null for movies.

number | null

required

Episode number. null for movies.

boolean

required

true if the provider returned a URL that passed stream verification.

string | null

Fully-qualified, proxied stream URL if the provider returned a valid stream. null on failure. Always an absolute URL — no base URL prepending needed.

string | null

The original, unproxied stream URL from the provider. Useful for debugging. null on failure.

number

required

Time in milliseconds from the start of the test to receiving a result.

string | null

required

Error message if the provider threw an exception or returned nothing. null on success.

Responses

{
  "source": "provider-a",
  "id": "550",
  "s": null,
  "e": null,
  "ok": true,
  "url": "https://api.vyla.cc/api?url=https%3A%2F%2F...&pa=1",
  "raw_url": "https://...",
  "elapsed_ms": 1204,
  "error": null
}

{
  "source": "provider-b",
  "id": "1396",
  "s": 1,
  "e": 1,
  "ok": true,
  "url": "https://api.vyla.cc/api?url=https%3A%2F%2F...&pb=1",
  "raw_url": "https://...",
  "elapsed_ms": 980,
  "error": null
}

HTTP status is still 200 even when the source fails.

{
  "source": "provider-c",
  "id": "550",
  "s": null,
  "e": null,
  "ok": false,
  "url": null,
  "raw_url": null,
  "elapsed_ms": 435,
  "error": "no stream returned"
}

{ "error": "Missing API key. Provide via Authorization header or X-API-Key header." }

{ "error": "Public keys cannot access test endpoints" }

{ "error": "invalid or missing source" }

Testing All Sources

To test all providers in one go and see which are working for a given title:

const BASE = 'http://localhost:7860';

async function testAll(tmdbId, season, episode) {
  const { token } = await fetch(`${BASE}/api/auth`, { method: 'POST' }).then(r => r.json());

  const meta = await fetch(`${BASE}/api?sources_meta=1`).then(r => r.json());
  const sourceKeys = meta.sources.map(s => s.key);

  const params = new URLSearchParams({ source: '' });
  if (season && episode) { params.set('season', season); params.set('episode', episode); }

  const results = await Promise.all(
    sourceKeys.map(source =>
      fetch(`${BASE}/api/test/${tmdbId}?${params.toString()}&source=${source}`, {
        headers: { 'X-Session-Token': token }
      })
        .then(r => r.json())
        .catch(err => ({ source, ok: false, error: err.message, elapsed_ms: null }))
    )
  );

  results.forEach(r => {
    const status = r.ok ? '✓' : '✗';
    const time   = r.elapsed_ms != null ? `${r.elapsed_ms}ms` : 'N/A';
    console.log(`${status} ${r.source.padEnd(12)} ${time.padStart(7)}  ${r.error || ''}`);
  });
}

testAll(550);

For a quick overview without per-provider isolation, use /api/health — it probes all providers simultaneously and is optimised for monitoring. Health accepts public_api_key.

Stream Sources

Subtitles

Downloads

Utilities

Test a Source

Path Parameters

Query Parameters

Request

Response

Responses

Testing All Sources

​Path Parameters

​Query Parameters

​Request

​Response

​Responses

​Testing All Sources

Path Parameters

Query Parameters

Request

Response

Responses

Testing All Sources