ph-scraper-api 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 suneththarind
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,120 @@
+# 🚀 PornHub Scraper API
+
+![NPM Version](https://img.shields.io/npm/v/ph-scraper-api)
+![NPM Downloads](https://img.shields.io/npm/dm/ph-scraper-api)
+![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)
+
+A high-performance, lightweight **Node.js** library to search videos and extract direct **HLS (m3u8)** streaming links and metadata from PornHub.
+
+---
+
+## ✨ Features
+
+* 🔍 **Smart Search**: Search videos with customizable result limits.
+* 📊 **Deep Metadata**: Extract titles, views, duration, and high-quality thumbnails.
+* ⚡ **Stream Extractor**: Get direct HLS links for all available qualities (1080p, 720p, 480p, etc.).
+* 📥 **Buffer Downloader**: Built-in support to process HLS streams into Buffers using FFmpeg.
+
+---
+
+## ⚙️ Prerequisites
+
+To use the **`downloadBuffer()`** feature, you must have **FFmpeg** installed on your system.
+
+* **Termux:** `pkg install ffmpeg`
+* **Linux:** `sudo apt install ffmpeg`
+* **Windows:** Install via [ffmpeg.org](https://ffmpeg.org/download.html)
+
+---
+
+## 🛠️ Installation
+
+Install the package via npm:
+
+```bash
+npm install ph-scraper-api
+```
+
+🚀 Usage Guide
+​After installing, you can import and use the scraper in your project:
+
+```bash
+const ph = require('ph-scraper-api');
+
+(async () => {
+    try {
+        // 1. Search for videos
+        const results = await ph.search('funny', 2);
+        console.log(results);
+
+        // 2. Extract Metadata & HLS Links
+        if (results.length > 0) {
+            const videoData = await ph.download(results[0].vkey);
+            console.log(videoData);
+        }
+    } catch (err) {
+        console.error("Scraper Error:", err.message);
+    }
+})();
+
+```
+
+📊 Example Outputs
+​🔍 Search Result Example (.search())
+​The search function returns an Array of Objects:
+```bash
+[
+  {
+    "title": "Funny Prank Video",
+    "vkey": "ph64xxxxxxxx",
+    "duration": "10:05",
+    "views": "1.2M",
+    "url": "[https://www.pornhub.com/view_video.php?viewkey=ph64xxxxxxxx](https://www.pornhub.com/view_video.php?viewkey=ph64xxxxxxxx)",
+    "thumb": "[https://ei.phncdn.com/videos/.../original/1.jpg](https://ei.phncdn.com/videos/.../original/1.jpg)"
+  },
+  {
+    "title": "Another Funny Clip",
+    "vkey": "ph65yyyyyyyy",
+    "duration": "05:20",
+    "views": "500K",
+    "url": "[https://www.pornhub.com/view_video.php?viewkey=ph65yyyyyyyy](https://www.pornhub.com/view_video.php?viewkey=ph65yyyyyyyy)",
+    "thumb": "[https://ei.phncdn.com/videos/.../original/2.jpg](https://ei.phncdn.com/videos/.../original/2.jpg)"
+  }
+]
+```
+⚡ Download Info Example
+The download function returns a Single Object with all available stream qualities:
+```bash
+{
+  "title": "Funny Prank Video",
+  "thumb": "[https://ei.phncdn.com/videos/.../original/1.jpg](https://ei.phncdn.com/videos/.../original/1.jpg)",
+  "duration": "10:05",
+  "hls": {
+    "1080p": "[https://km-h.phncdn.com/hls/.../1080P_4000K.m3u8?token=](https://km-h.phncdn.com/hls/.../1080P_4000K.m3u8?token=)...",
+    "720p": "[https://km-h.phncdn.com/hls/.../720P_2000K.m3u8?token=](https://km-h.phncdn.com/hls/.../720P_2000K.m3u8?token=)...",
+    "480p": "[https://km-h.phncdn.com/hls/.../480P_1000K.m3u8?token=](https://km-h.phncdn.com/hls/.../480P_1000K.m3u8?token=)...",
+    "240p": "[https://km-h.phncdn.com/hls/.../240P_400K.m3u8?token=](https://km-h.phncdn.com/hls/.../240P_400K.m3u8?token=)..."
+  }
+}
+```
+
+
+📊 API Reference
+
+​.search(query, limit)
+​query (String): Search keyword.
+​limit (Number): Max results (default is 10).
+
+​.download(vkey_or_url)
+​vkey_or_url (String): The video vkey or the full PornHub URL.
+​Returns: Metadata object with HLS links.
+
+​.downloadBuffer(vkey, quality)
+​vkey (String): The video identifier.
+​quality (String): Video quality (e.g., '1080', '720', '480').
+
+​👨‍💻 Author
+Keshara Liyanaarachchi
+
+​📜 License
+​MIT License. For educational purposes only.

package/index.js

@@ -0,0 +1 @@
+function a0_0x1a2d(){const _0x4a234d=['find','sort','each','_extractMediaDefinitions','script[type=\x22application/ld+json\x22]','match','html','thumbnailUrl','child_process','phdl-','hls','11160lnbbqX','message','replace','1084076OqrSsa','text','filter','attr','6670899UTUTFk','first','li[data-video-vkey]','videoUrl','data-video-vkey','ffmpeg\x20-v\x20quiet\x20-y\x20-user_agent\x20\x22','mediaDefinitions','/video/search?search=','444pumfXS','img','quality','baseUrl','No\x20video\x20qualities\x20found.','316Xzebjx','2607336xgnQDX','duration','_parseDuration','indexOf','format','title','get','trim','720','h1.title\x20span','parse','thumb','/view_video.php?viewkey=','forEach','.duration','.views\x20var','values','Search\x20failed:\x20','79568wzlqSn','downloadBuffer','download','padStart','Mozilla/5.0\x20(Linux;\x20Android\x2011;\x20Redmi\x20Note\x208)\x20AppleWebKit/537.36\x20(KHTML,\x20like\x20Gecko)\x20Chrome/120.0.0.0\x20Mobile\x20Safari/537.36','promises','\x22\x20-t\x20300\x20-c\x20copy\x20-bsf:a\x20aac_adtstoasc\x20\x22','exports','https://www.pornhub.com','.title\x20a','length','includes','553TwyfGZ','No\x20Title','push','search','5333120SkgReY','15605PuUQrv','map'];a0_0x1a2d=function(){return _0x4a234d;};return a0_0x1a2d();}const a0_0x31751d=a0_0x1cbe;(function(_0x3a0010,_0x24bfa){const _0x9f2360=a0_0x1cbe,_0x1d66ae=_0x3a0010();while(!![]){try{const _0x5527de=-parseInt(_0x9f2360(0x1f0))/0x1+-parseInt(_0x9f2360(0x1ed))/0x2*(-parseInt(_0x9f2360(0x1fc))/0x3)+-parseInt(_0x9f2360(0x201))/0x4*(-parseInt(_0x9f2360(0x225))/0x5)+-parseInt(_0x9f2360(0x202))/0x6+-parseInt(_0x9f2360(0x220))/0x7*(-parseInt(_0x9f2360(0x214))/0x8)+parseInt(_0x9f2360(0x1f4))/0x9+-parseInt(_0x9f2360(0x224))/0xa;if(_0x5527de===_0x24bfa)break;else _0x1d66ae['push'](_0x1d66ae['shift']());}catch(_0x33d86b){_0x1d66ae['push'](_0x1d66ae['shift']());}}}(a0_0x1a2d,0x85a48));function a0_0x1cbe(_0x57809d,_0x17e54e){_0x57809d=_0x57809d-0x1e6;const _0x1a2dfa=a0_0x1a2d();let _0x1cbef0=_0x1a2dfa[_0x57809d];return _0x1cbef0;}const axios=require('axios'),cheerio=require('cheerio'),{exec}=require(a0_0x31751d(0x1ea)),{promisify}=require('util'),{mkdtemp,rm,readFile}=require('fs')[a0_0x31751d(0x219)],{join}=require('path'),{tmpdir}=require('os'),execAsync=promisify(exec),UA=a0_0x31751d(0x218);class PornHub{constructor(){const _0x2e50c4=a0_0x31751d;this[_0x2e50c4(0x1ff)]=_0x2e50c4(0x21c);}['_parseDuration'](_0x41cce3){const _0x4f7509=a0_0x31751d;if(!_0x41cce3)return null;const _0x4c2d92=_0x41cce3[_0x4f7509(0x1e7)](/PT(\d+)H(\d+)M(\d+)S/);if(!_0x4c2d92)return _0x41cce3;const _0x430c9d=parseInt(_0x4c2d92[0x1]),_0x3fba77=parseInt(_0x4c2d92[0x2]),_0x29097a=parseInt(_0x4c2d92[0x3]);if(_0x430c9d>0x0)return _0x430c9d+':'+String(_0x3fba77)[_0x4f7509(0x217)](0x2,'0')+':'+String(_0x29097a)['padStart'](0x2,'0');return _0x3fba77+':'+String(_0x29097a)[_0x4f7509(0x217)](0x2,'0');}[a0_0x31751d(0x22a)](_0x2a3786){const _0x44ec06=a0_0x31751d,_0x22a544=_0x2a3786[_0x44ec06(0x205)](_0x44ec06(0x1fa));if(_0x22a544===-0x1)return null;const _0x14c786=_0x2a3786[_0x44ec06(0x205)]('[',_0x22a544);if(_0x14c786===-0x1)return null;let _0x115e1e=0x0,_0x48012f=-0x1;for(let _0xc70f2c=_0x14c786;_0xc70f2c<_0x2a3786[_0x44ec06(0x21e)];_0xc70f2c++){if(_0x2a3786[_0xc70f2c]==='[')_0x115e1e++;else{if(_0x2a3786[_0xc70f2c]===']'){_0x115e1e--;if(_0x115e1e===0x0){_0x48012f=_0xc70f2c;break;}}}}try{return JSON[_0x44ec06(0x20c)](_0x2a3786['slice'](_0x14c786,_0x48012f+0x1)[_0x44ec06(0x1ef)](/\\\//g,'/'));}catch{return null;}}async[a0_0x31751d(0x223)](_0x5c8ab5,_0x3c6f26=0xa){const _0x374cdf=a0_0x31751d;try{const {data:_0x4ebb65}=await axios[_0x374cdf(0x208)](this['baseUrl']+_0x374cdf(0x1fb)+encodeURIComponent(_0x5c8ab5),{'headers':{'User-Agent':UA},'timeout':0x2ee0}),_0x46070d=cheerio['load'](_0x4ebb65),_0x3d1b05=[];return _0x46070d(_0x374cdf(0x1f6))[_0x374cdf(0x229)]((_0x49c19c,_0x5f262b)=>{const _0x5dcfea=_0x374cdf;if(_0x3d1b05[_0x5dcfea(0x21e)]>=_0x3c6f26)return![];const _0x51aa46=_0x46070d(_0x5f262b)[_0x5dcfea(0x1f3)](_0x5dcfea(0x1f8)),_0xce57e7=_0x46070d(_0x5f262b)[_0x5dcfea(0x227)](_0x5dcfea(0x21d))[_0x5dcfea(0x1f5)]()['text']()['trim']();_0x51aa46&&_0xce57e7&&_0x3d1b05[_0x5dcfea(0x222)]({'title':_0xce57e7,'vkey':_0x51aa46,'duration':_0x46070d(_0x5f262b)[_0x5dcfea(0x227)](_0x5dcfea(0x210))[_0x5dcfea(0x1f1)]()[_0x5dcfea(0x209)](),'views':_0x46070d(_0x5f262b)['find'](_0x5dcfea(0x211))[_0x5dcfea(0x1f1)]()[_0x5dcfea(0x209)](),'url':this[_0x5dcfea(0x1ff)]+_0x5dcfea(0x20e)+_0x51aa46,'thumb':_0x46070d(_0x5f262b)[_0x5dcfea(0x227)](_0x5dcfea(0x1fd))[_0x5dcfea(0x1f3)]('src')});}),_0x3d1b05;}catch(_0x3d7d2d){throw new Error(_0x374cdf(0x213)+_0x3d7d2d[_0x374cdf(0x1ee)]);}}async[a0_0x31751d(0x216)](_0x5041ae){const _0xbb11de=a0_0x31751d,_0x4abefc=_0x5041ae[_0xbb11de(0x21f)]('viewkey=')?_0x5041ae:this[_0xbb11de(0x1ff)]+_0xbb11de(0x20e)+_0x5041ae,{data:_0x4d58e4}=await axios['get'](_0x4abefc,{'headers':{'User-Agent':UA},'timeout':0x2ee0}),_0x2ae564=cheerio['load'](_0x4d58e4),_0x5c69d9=_0x2ae564('script')[_0xbb11de(0x226)]((_0x3812ee,_0x1835d1)=>_0x2ae564(_0x1835d1)[_0xbb11de(0x1e8)]())['get']();let _0x181db7=null;for(const _0x4b463d of _0x5c69d9){if(!_0x4b463d||!_0x4b463d[_0xbb11de(0x21f)](_0xbb11de(0x1fa)))continue;_0x181db7=this['_extractMediaDefinitions'](_0x4b463d);if(_0x181db7)break;}if(!_0x181db7)throw new Error(_0xbb11de(0x200));const _0x7e383c=_0x181db7[_0xbb11de(0x1f2)](_0x1d251a=>_0x1d251a[_0xbb11de(0x206)]===_0xbb11de(0x1ec)&&_0x1d251a[_0xbb11de(0x1f7)]&&_0x1d251a[_0xbb11de(0x1fe)])[_0xbb11de(0x228)]((_0x5de5b4,_0x119696)=>parseInt(_0x119696['quality'])-parseInt(_0x5de5b4[_0xbb11de(0x1fe)])),_0x42222c=_0x2ae564(_0xbb11de(0x1e6))[_0xbb11de(0x1f5)]()['html']();let _0x596eb8={'title':null,'thumb':null,'duration':null,'hls':{}};if(_0x42222c)try{const _0x17c4c4=JSON[_0xbb11de(0x20c)](_0x42222c);_0x596eb8[_0xbb11de(0x207)]=_0x17c4c4['name']||null,_0x596eb8[_0xbb11de(0x20d)]=_0x17c4c4[_0xbb11de(0x1e9)]||null,_0x596eb8['duration']=this[_0xbb11de(0x204)](_0x17c4c4[_0xbb11de(0x203)]);}catch{}if(!_0x596eb8[_0xbb11de(0x207)])_0x596eb8['title']=_0x2ae564(_0xbb11de(0x20b))[_0xbb11de(0x1f1)]()['trim']()||_0xbb11de(0x221);return _0x7e383c[_0xbb11de(0x20f)](_0xa9fb45=>{const _0x2007ab=_0xbb11de;_0x596eb8[_0x2007ab(0x1ec)][_0xa9fb45['quality']+'p']=_0xa9fb45[_0x2007ab(0x1f7)];}),_0x596eb8;}async[a0_0x31751d(0x215)](_0x1b9ae6,_0x16371d=a0_0x31751d(0x20a)){const _0x4b7406=a0_0x31751d,_0x29fddb=await this[_0x4b7406(0x216)](_0x1b9ae6),_0x308fcf=_0x29fddb[_0x4b7406(0x1ec)][_0x16371d+'p']||Object[_0x4b7406(0x212)](_0x29fddb[_0x4b7406(0x1ec)])[0x0],_0x230871=await mkdtemp(join(tmpdir(),_0x4b7406(0x1eb))),_0x22ab13=join(_0x230871,'video.mp4');try{await execAsync(_0x4b7406(0x1f9)+UA+'\x22\x20-headers\x20\x22Referer:\x20https://www.pornhub.com/\x0d\x0a\x22\x20-i\x20\x22'+_0x308fcf+_0x4b7406(0x21a)+_0x22ab13+'\x22',{'timeout':0x1d4c0});const _0x3b797f=await readFile(_0x22ab13);return{'title':_0x29fddb[_0x4b7406(0x207)],'buffer':_0x3b797f};}finally{await rm(_0x230871,{'recursive':!![],'force':!![]});}}}module[a0_0x31751d(0x21b)]=new PornHub();

package/package.json

@@ -0,0 +1,21 @@
+{
+  "name": "ph-scraper-api",
+  "version": "1.0.0",
+  "description": "A lightweight Node.js scraper for searching and extracting HLS download links from PornHub.",
+  "main": "index.js",
+  "scripts": {
+    "test": "node index.js"
+  },
+  "keywords": [
+    "ph-scraper",
+    "downloader",
+    "video-search",
+    "hls-extractor"
+  ],
+  "author": "Keshara Liyanaarachchi",
+  "license": "MIT",
+  "dependencies": {
+    "axios": "^1.6.0",
+    "cheerio": "^1.0.0-rc.12"
+  }
+}