GET /api/scrape

Fetch raw sources from a single provider by TMDB ID

GET /api/scrape

GET /api/scrape

cURL

curl --request GET \
  --url https://vyla-api.pages.dev/api/scrape

200

{
  "success": true,
  "sources": [
    {
      "url": "<string>",
      "type": "<string>",
      "quality": "<string>",
      "provider": "<string>",
      "audioTracks": [
        {}
      ],
      "headers": {}
    }
  ],
  "subtitles": [
    {
      "url": "<string>",
      "label": "<string>",
      "format": "<string>"
    }
  ]
}

Runs a single provider’s scraper and returns raw sources and subtitles. This is the internal building block used by /api/stream/movie, /api/stream/tv, /api/download/movie, and /api/download/tv — those endpoints call /api/scrape once per provider in parallel so each gets its own isolated CPU budget.

Call it directly if you only want results from a specific provider, or want to fan out requests yourself.

Sources from /api/scrape are raw — no deduplication, no download_url, no ffmpeg_command, no proxied vlc_url. Use /api/stream/movie or /api/stream/tv for fully enriched results.

Query Parameters

id · string · required

TMDB movie or series ID.

provider · string · required

Provider key. Must be one of: moviedownloader, vixsrc, vidsrc, uembed, vidrock, rgshows, vidzee, embed02

type · string · default: "movie"

movie or tv

season · number · default: "1"

Season number — TV only.

episode · number · default: "1"

Episode number — TV only.

Example Request

Single provider — movie

curl "https://vyla-api.pages.dev/api/scrape?type=movie&id=550&provider=vixsrc"

Firing all 8 provider requests with Promise.all and merging the results is exactly what /api/stream/movie and /api/stream/tv do internally — use those endpoints to get the enriched, deduplicated output without managing it yourself.

Valid Provider Keys

Key	Provider
moviedownloader	MovieDownloader
vixsrc	VixSrc
vidsrc	VidSrc
uembed	UEmbed
vidrock	VidRock
rgshows	RgShows
vidzee	VidZee
embed02	Embed02

Response

success · boolean · required

true if scraping succeeded.

sources · RawSource[] · required

Raw array of sources from the specified provider. No deduplication or enrichment applied.

Show RawSource object

url · string

Direct stream URL.

type · string

hls, mp4, or mkv

quality · string

e.g. 1080p, 720p, unknown

provider · string

Provider name.

audioTracks · AudioTrack[]

Available audio tracks with language and label.

headers · object

Required Referer and Origin headers for this CDN.

subtitles · Subtitle[] · required

Raw subtitle array from the specified provider.

Show Subtitle object

url · string

Direct URL to the subtitle file.

label · string

Display name.

format · string

vtt or srt

200 Success

{
  "success": true,
  "sources": [
    {
      "url": "https://vixsrc.to/playlist/170060?token=...&expires=...&h=1",
      "type": "hls",
      "quality": "1080p",
      "provider": "VixSrc",
      "audioTracks": [
        { "language": "eng", "label": "English" }
      ],
      "headers": {
        "Referer": "https://vixsrc.to/",
        "Origin": "https://vixsrc.to"
      }
    }
  ],
  "subtitles": [
    {
      "url": "https://vixsrc.to/playlist/170060?type=subtitle&rendition=eng&token=...&expires=...&edge=...",
      "label": "English",
      "format": "vtt"
    }
  ]
}

400 Error

{ "success": false, "error": "Missing id" }

{ "success": false, "error": "Invalid or missing provider" }