🕷️ xhamster-scraper

A highly robust media indexing parser workflow designed to query specific properties, extract manifest links, and download streaming data segments cleanly from xHamster.

Report Bug · Request Feature

✨ Features

• 🏷️ Clean Selector Mapping: Efficiently tracks thumb paths, structural durations, tracking view counts, and video layouts.
• 🛡️ Custom Header Optimization: Mimics mobile tracking structures to reliably parse content without encountering firewall blocks.
• 🔗 HLS Manifest Breakdown: Extracts and formats raw underlying stream properties natively into selectable quality structures.

📥 Installation

Install using your project's default package manager client terminal environment:

npm install xhamster-scraper




📈 **Example code Search**
```js
const { xhamsterSearch } = require('xhamster-scraper');

async function run() {
    try {
        console.log("Searching matching targets...");
        const results = await xhamsterSearch('funny cat', 20);
        
        console.log("\n--- Search Query Results ---");
        console.log(JSON.stringify(results, null, 20));
    } catch (error) {
        console.error("Search module error:", error.message);
    }
}

run();

📈 Output Search

[
          {
                    "title": "Marvel - Black Cat VS Venom Special (Animation with Sounds)",
                    "url": "https://xhamster.com/videos/marvel-black-cat-vs-venom-special-animation-with-sounds-xhyki4P",
                    "thumb": "https://ic-vt-nss.xhpingcdn.com/a/Y2NmNWU5NzQ5ZTlkZGZjYmJjM2U4NGUxNzkyNTU3YTA/s(w:640,h:360),webp/023/999/982/1280x720.c.jpg.v1699975180",
                    "preview": "https://thumb-v2.xhpingcdn.com/a/SuYJ1TrptKSELT5-Uao7Ew/023/999/982/526x298.94.3.4.t.av1.mp4",
                    "duration": "07:52",
                    "views": "1.2M views"
          },
          {
                    "title": "Marvel - Black Cat VS Venom Special (Animation with Sounds)",
                    "url": "https://xhamster.com/videos/marvel-black-cat-vs-venom-special-animation-with-sounds-xhyki4P",
                    "thumb": "",
                    "preview": "",
                    "duration": "",
                    "views": "1.2M views"
          }
]

📈 Example code DL

const { xhamsterDownload } = require('xhamster-scraper');

async function run() {
    try {
        const url = 'https://xhamster.com/videos/very-sexy-young-pussy-5602698';
        console.log("Analyzing page layout data structure...");
        
        const metadata = await xhamsterDownload(url);
        console.log("\n--- Structural Extraction Result ---");
        console.log(JSON.stringify(metadata, null, 2));
    } catch (error) {
        console.error("Meta parse exception:", error.message);
    }
}

run();

📈 Output Dl

{
  "title": "Video Title Asset",
  "thumb": "https://images-thumb.xhcdn.com/videos/",
  "duration": "12:45",
  "views": 15420,
  "download": {
    "720p": {
      "quality": "720p",
      "url": "https://hls-stream-link.mp4",
      "format": "hls"
    }
  }
}