Extractor Docs

Extractor Extensions

Contract for host resolvers

Extractors receive host/embed URLs and return final playable streams with optional headers.

01

`EXTRACTOR` object

Include `id`, `name`, `domains` and `version` so runtime routing can match host URLs correctly.

02

`extractVideos(url)`

Resolve embeds into direct streams. Return one or many candidates with quality labels.

03

Return stream objects

Use `{ url, quality, headers? }`. Include `Referer` headers where hosts require it.

const EXTRACTOR = {
  id: "my-host",
  name: "My Host",
  domains: ["my-host.com", "embed.my-host.com"],
  version: "1.0.0"
};

async function extractVideos(url) {
  // Resolve tokens, API payloads or script vars here.
  return [
    {
      url: "https://cdn.my-host.com/master.m3u8",
      quality: "1080p",
      headers: { Referer: url }
    },
    {
      url: "https://cdn.my-host.com/720.mp4",
      quality: "720p",
      headers: { Referer: url }
    }
  ];
}