JustalK/PORNHUB-API - Githubissues

Alt text

Last version npm

Powerful updated scraper for PornHub. Unlike others scrapers, it's working in 2020 October with their new website. It allows you to get any informations out of any page.

Installation

npm install @justalk/pornhub-api

or if you use yarn

yarn add @justalk/pornhub-api --ignore-engines

Short Examples

Scraping the title, pornstars and the download links of a page

const pornhub = require('@justalk/pornhub-api');
const url = 'https://www.pornhub.com/view_video.php?viewkey=ph56fc59c124c0c';
const video = await pornhub.page(url, ['title','pornstars','download_urls']);

Features

Scraper: Parse any page of pornhub : search page, model, video page...
Download links: Get the download links in all the quality without registering
Search pagination: This api can scrap multiple page at the same time
Search by different criteria: Possibility to scrap different part of the site and to take advantage of the filter
Flexible: The results are always return in a very specific javascrypt type making it easy to integrate to your need.

Scraping of a single video page pornhub

async page(url, options)

name	type	description	default
url	String	[Mandatory] url of the page	-
keys	Array	List of the keys	['title']

Lists of options available for a search (click to show)

Scraping of a search page pornhub

async search(value, keys, options)

name	type	description
value	String	value search in pornhub
keys	Array or String if there is only one option	List of the keys
options	Array	[OPTIONNAL] List of the optional options

Lists of options available for a search (click to show)

Lists of keys available for a search by video (click to show)

Lists of keys available for a porn actor search (click to show)

Lists of keys available for a gifs search (click to show)

Scraping of a special search page by category

There are two kind of possible way to search on pornhub. The first one is to search by term and the second one is to search by filter. This call is for the search by category and subcategory.

async video(keys, options)

name	type	description	default
keys	Array or String if there is only one option	[OPTIONNAL] List of the keys	null
options	Array	[OPTIONNAL] List of the optional options	null

Lists of keys available for a special search page by category (click to show)

Lists of options available for a search (click to show)

Model page pornhub

async model(name, keys)

name	type	description
name	String	name of the model in pornhub
keys	Array or String if there is only one option	List of the keys
type	String	There is two kind of model : pornstar or model

Lists of keys available for a model page (click to show)

Examples

Scraping the title of a video (click to show)

```js const pornhub = require('@justalk/pornhub-api'); const video = await pornhub.page(url, ['title']); ``` ```json { "title": "Name of the video" } ```

Scraping the title of a video and the description (click to show)

```js const pornhub = require('@justalk/pornhub-api'); const video = await pornhub.page(url, ['title','description']); ``` ```json { "title": "Name of the video", "description": "Description of the video" } ```

Scraping the name of the pornstars and the downloads links (click to show)

```js const pornhub = require('@justalk/pornhub-api'); const video = await pornhub.page(url, ['title','pornstars','download_urls']); ``` ```json { "title": "Title of the video", "pornstars": ["Sophie A","Rocco B"], "download_urls": { "720" : "https://p.com/link1", "480" : "https://p.com/link2", "360" : "https://p.com/link3" } } ```

Scraping a search pornhub without options (click to show)

```js const pornhub = require('@justalk/pornhub-api'); const video = await pornhub.search("Aa",["title","link","premium","hd"]); ``` ```json [{ "link": "https://p.com/link1", "title": "Title of the video", "hd": true, "premium": true },{ "link": "https://p.com/link2", "title": "Title of the video", "hd": false, "premium": false }] ```

Scraping a search pornhub with options (click to show)

```js const pornhub = require('@justalk/pornhub-api'); const video = await pornhub.search("Aa",["actor","rank"],{production: 'homemade', search: 'pornstars'}); ``` ```json [{ "actor": "Herica Alue", "rank": 8005, },{ "actor": "Robert Laach", "rank": 60 },{ "actor": "Aalix Lolo", "rank": 6500 }] ```

How to test/contribute

How to test the API ? (click to show)

For testing, install the node project and run the test command. ```shell node install npm test ``` Also, you can use the command under for running the test without the linter ```shell npm run test-no ``` The tests are not execute on pornhub directly, the calls to pornhub are all mock with `nock` to save html page of pornhub. It has been done for having page that wont evolve through time. By example, if a comment is added on the real link, the tests will still be ok.

How to contribute ? (click to show)

Any contribution is welcomed ! If you find an issue or just want to add your stone to the castle : 1. Open an issue 2. Fork the repository 3. Create a new branch 4. Pull Request your change 5. Wait until I check your code 6. Merge and add your name on this page forever !

Note

Why does it not work in my country ? (click to show)

If pornhub is blocked in your country, the API will obviously not work. You will need a proxy.

Why does it not work at all sometimes ? (click to show)

Pornuhub has a scraper protection, if you scrap the website violently (let say hundreds pages in 10 seconds), your ip will be flag as a bot for few minute. Please be gentle with pornhub's server !