📖 About FetchStream API

Note

FetchStream API is a specialized, high-performance streaming link extraction engine built by Unrated Coder ™ & 『 SHADOW × PARADOX × CODERS TM 』. It is designed to fetch embedded anime/toon streaming links, bypass annoying click-ad overlays, and extract direct download mirrors cleanly inside a Vercel serverless environment.

Core System Features

• Embedded Stream Extraction: Directly hooks into third-party anime players to pull raw playable streaming URLs.
• Automated Ad-Bypasser: Crawls hidden iframe wrappers and bypasses malicious click-ad overlays to reveal clean player links.
• Direct Download Fetcher: Extracts high-speed direct download links (Ruby, GDMirror, etc.) without human intervention.
• Base64 Audio Unpacking: Automatically decodes localized audio configurations (Hindi, Tamil, Telugu, Japanese).
• Rich TMDb Integration: Maps records with high-definition screenshots, official overviews, and air-dates.

🎯 Target Platforms & Ecosystem

Tip

AnimeSalt (animesalt.cx) > Deep series indexer, season mapper, and Base64 localized stream payloads.

Important

ToonStream (toon-stream.site) > Anime/cartoon stream database featuring automated background verification and ad-wall stripping.

Caution

TMDb Database (themoviedb.org) > Official promotional art engine providing crisp backdrop images and episode titles.

🚀 Live Production Endpoint

https://fetch-stream.vercel.app

🔌 Comprehensive API Endpoints Reference

1. Unified Multi-Site Search

Queries all integrated target platforms concurrently in a single thread, normalizing divergent search results into a unified payload format.

• Endpoint: GET /search
• Query Parameter: q (String, Required) — Target search keyword (e.g., Boruto, Chainsaw Man).

📥 Sample Request

GET https://fetch-stream.vercel.app/search?q=Boruto

📤 Sample JSON Response (200 OK)

{
  "query": "Boruto",
  "total": 2,
  "results": [
    {
      "title": "Boruto: Naruto Next Generations",
      "link": "https://animesalt.cx/series/boruto-naruto-next-generations/",
      "image": "https://image.tmdb.org/t/p/w500/e0B6i48kxdRkMcK4tR4YNfXGWOc.jpg",
      "source": "AnimeSalt"
    },
    {
      "title": "Boruto: Naruto Next Generations",
      "link": "https://toon-stream.site/series/boruto-naruto-next-generations",
      "image": "https://image.tmdb.org/t/p/w780/e0B6i48kxdRkMcK4tR4YNfXGWOc.jpg",
      "source": "ToonStream"
    }
  ]
}

---

2. Dedicated AnimeSalt Modules

• Search Module: GET /animesalt/search?q=<query>
• Episodes & Seasons: GET /animesalt/episodes?url=<series_url> (Extracts native layout thumbnails)
• Stream Extractor: GET /animesalt/streams?url=<episode_url> (Decodes Base64 localized streaming links)

📤 Sample Response (/animesalt/episodes)

{
  "seasons": [
    { "name": "Season 1 • 1-11 (11)", "seasonNum": "1", "postId": "2308" }
  ],
  "episodes": [
    {
      "epNum": "1",
      "title": "Daemons of the Shadow Realm 1x1",
      "link": "https://animesalt.cx/episode/daemons-of-the-shadow-realm-1x1/",
      "image": "https://img.animesalt.cx/images-unified/thumb_2308_s1e1.jpg"
    }
  ]
}

---

3. Dedicated ToonStream Modules & Embed/Download Extractor

• Search Module: GET /toonstream/search?q=<query>
• Grid Episode Extractor: GET /toonstream/episodes?url=<series_url>
• Embed Stream & Direct Download Resolver: GET /toonstream/streams?url=<episode_url> (Bypasses click-ads and fetches raw stream / download links)

📤 Sample Response (/toonstream/streams)

{
  "streams": [
    {
      "server": "Short",
      "link": "https://toon-stream.site/embed/81227690d56aef40",
      "is_bypassed": true
    }
  ],
  "downloads": [
    {
      "server": "Ruby",
      "link": "https://rubystm.com/d/sbsp0glxo8h1.html"
    },
    {
      "server": "GDMirror",
      "link": "https://gdmirrorbot.nl/file/ihqrdvu"
    }
  ]
}

---

4. Official TMDb Metadata & Thumbnail Service

A fallback endpoint returning crisp high-definition episode screenshots, overviews, and release timelines via structural title tracking.

• Endpoint: GET /tmdb/episode-thumbnail
• Query Parameters: title (String), season (Number), episode (Number)

📥 Sample Request

GET https://fetch-stream.vercel.app/tmdb/episode-thumbnail?title=Chainsaw%20Man&season=1&episode=4

📤 Sample JSON Response (200 OK)

{
  "found": true,
  "tv_id": 114410,
  "show_title": "Chainsaw Man",
  "episode_name": "Rescue",
  "overview": "Denji has a simple dream...",
  "air_date": "2022-11-01",
  "thumbnails": {
    "w500": "https://image.tmdb.org/t/p/w500/78p3CwjbIbJv2MucbLWnvBtF34d.jpg",
    "w780": "https://image.tmdb.org/t/p/w780/78p3CwjbIbJv2MucbLWnvBtF34d.jpg",
    "original": "https://image.tmdb.org/t/p/original/78p3CwjbIbJv2MucbLWnvBtF34d.jpg"
  }
}

🛠️ Local Installation & Setup

To boot and test this microservice locally on your computer:

# 1. Clone repository
git clone https://github.com/Unrated-Coder/Fetch-Stream-API.git

# 2. Enter workspace directory
cd fetch-stream

# 3. Install required node packages
npm install

# 4. Boot up local environment
npm start

The local development server will start on http://localhost:3000

☁️ Serverless Deployment

Configured natively with a root-level vercel.json routing configuration file.

1. Connect your repository to the Vercel Dashboard.
2. Hit Deploy. Vercel will compile and spin up your endpoints instantly.

⚡ Tech Stack & Tools Used

🤝 Contributors & Joint Partners

Note

FetchStream API is a collaborative effort between two passionate development teams. This project thrives on the combined expertise of Unrated Coder and 『 SHADOW × PARADOX × CODERS TM 』.

Unrated Coder ™ Core Architecture & API Engineering

『 SHADOW × PARADOX × CODERS 』 Integration, UI/UX & Community Growth

⚠️ Disclaimer & Legal Compliance

Caution

This repository is built strictly for educational research and analytical integration. FetchStream acts as an abstract data indexer querying public web records. It does not store, host, or re-transmit copyrighted media binaries on its servers.

🌐 Connect With The Builders

  

  

Star this repository if it helps your automation or development workflow!