# PornHub Scraper (`jupri/pornhub`) Actor
💫 Scrape Pornhub.com Resources
- **URL**: https://apify.com/jupri/pornhub.md
- **Developed by:** [cat](https://apify.com/jupri) (community)
- **Categories:** Videos, Social media
- **Stats:** 481 total users, 6 monthly users, 83.8% runs succeeded, 7 bookmarks
- **User rating**: 4.00 out of 5 stars
## Pricing
$5.00 / 1,000 results
This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event
## What's an Apify Actor?
Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".
## How to integrate an Actor?
If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.
In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md):
```bash
npm install apify-client
```
In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md):
```bash
pip install apify-client
```
In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md):
````bash
# MacOS / Linux
curl -fsSL https://apify.com/install-cli.sh | bash
# Windows
irm https://apify.com/install-cli.ps1 | iex
```bash
In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md).
If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md).
For usage examples, see the [API](#api) section below.
For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).
# README
## Welcome to PornHub Scraper
### About PornHub.com
**Pornhub** is a Canadian-owned [internet pornography](https://en.wikipedia.org/wiki/Internet_pornography "Internet pornography") video-sharing website, one of several owned by [adult entertainment](https://en.wikipedia.org/wiki/Sex_industry "Sex industry") [conglomerate](https://en.wikipedia.org/wiki/Media_conglomerate "Media conglomerate") [Aylo](https://en.wikipedia.org/wiki/Aylo "Aylo").[[2]](https://en.wikipedia.org/wiki/Pornhub#cite_note-theinquirer1-3)[[3]](https://en.wikipedia.org/wiki/Pornhub#cite_note-4) As of February 2024, Pornhub is the 13th-[most-visited website](https://en.wikipedia.org/wiki/List_of_most-visited_websites "List of most-visited websites") in the world and the second-most-visited adult website, after [XVideos](https://en.wikipedia.org/wiki/XVideos "XVideos").[[4]](https://en.wikipedia.org/wiki/Pornhub#cite_note-5)
The site allows visitors to view [pornographic videos](https://en.wikipedia.org/wiki/Pornography "Pornography") from various categories, including professional and [amateur pornography](https://en.wikipedia.org/wiki/Amateur_pornography "Amateur pornography"), and to upload and share their own videos. Content can be flagged if it violates the website's terms of service.[[5]](https://en.wikipedia.org/wiki/Pornhub#cite_note-6) The site also hosts the Pornhub Awards annually.
In December 2020, following a _[New York Times](https://en.wikipedia.org/wiki/The_New_York_Times "The New York Times")_ exposé of [non-consensual pornography](https://en.wikipedia.org/wiki/Revenge_porn "Revenge porn") and [sex trafficking](https://en.wikipedia.org/wiki/Sex_trafficking "Sex trafficking"), payment processors [Mastercard](https://en.wikipedia.org/wiki/Mastercard) and [Visa](https://en.wikipedia.org/wiki/Visa_Inc. "Visa Inc.") cut their services to Pornhub. Pornhub then removed all videos uploaded by unverified users,[[6]](https://en.wikipedia.org/wiki/Pornhub#cite_note-7) reducing the total content from 13 million to 4 million videos.[[7]](https://en.wikipedia.org/wiki/Pornhub#cite_note-Guardian_removal-8) A 2023 documentary, _[Money Shot: The Pornhub Story](https://en.wikipedia.org/wiki/Money_Shot:_The_Pornhub_Story "Money Shot: The Pornhub Story")_, covers the opposition to Pornhub and the views of some pornographic performers.[[8]](https://en.wikipedia.org/wiki/Pornhub#cite_note-9)
### About This Actor
>### This is an adult website
>This website contains age-restricted materials including nudity and explicit depictions of sexual activity. By entering, you affirm that you are at least 18 years of age or the age of majority in the jurisdiction you are accessing the website from and you consent to viewing sexually explicit content.
>### I am 18 or older - [Enter](https://console.apify.com/actors/9qKqLs1KywltNvdF8) | [I am under 18 - Exit](https://www.google.com/)
# Actor input Schema
## `query` (type: `array`):
💡 List of Search KEYWORDS or URL
## `resource` (type: `string`):
💡 Resource type for searching.
## `limit` (type: `integer`):
Minimum number of search results
## `dev_proxy_config` (type: `object`):
💡 Supported protocol:
HTTP(S), SOCKS5
{http|socks5}://{user:pass}@{hostname|ip-address}:port
Example: socks5://example.com:9000
## `dev_custom_headers` (type: `array`):
💡 Additional HTTP Headers
## `dev_custom_cookies` (type: `array`):
💡 Additional HTTP Cookies
## `dev_transform_fields` (type: `array`):
💡 Transform the resulting output. Select only needed fields.
For nested object use DOT. For example: address.streetAddress
For nested array use NUMBER (index of array element starting from index=0). For example: images.0.url
## `dev_dataset_name` (type: `string`):
💡 Save results into custom named Dataset, use mask to customize dataset name
{ACTOR} = actor name
{DATE} = date (YYYYMMDD)
{TIME} = time (HHMMSS)
This masks can be used to autogenerate Dataset Name.
example: data-{DATE}
Depending on today date the dataset name will be: data-20230603
default: data-{ACTOR}-{DATE}-{TIME}
## `dev_dataset_clear` (type: `boolean`):
Clear Dataset before insert/update.
## `dev_no_strip` (type: `boolean`):
💡 Keep/Save empty values (NULL, FALSE, empty ARRAY, empty OBJECT, empty STRING)
## Actor input object example
```json
{
"query": [
"square pants"
],
"limit": 5
}
````
# API
You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.
## JavaScript example
```javascript
import { ApifyClient } from 'apify-client';
// Initialize the ApifyClient with your Apify API token
// Replace the '' with your token
const client = new ApifyClient({
token: '',
});
// Prepare Actor input
const input = {
"query": [
"square pants"
],
"limit": 5
};
// Run the Actor and wait for it to finish
const run = await client.actor("jupri/pornhub").call(input);
// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
console.dir(item);
});
// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs
```
## Python example
```python
from apify_client import ApifyClient
# Initialize the ApifyClient with your Apify API token
# Replace '' with your token.
client = ApifyClient("")
# Prepare the Actor input
run_input = {
"query": ["square pants"],
"limit": 5,
}
# Run the Actor and wait for it to finish
run = client.actor("jupri/pornhub").call(run_input=run_input)
# Fetch and print Actor results from the run's dataset (if there are any)
print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
print(item)
# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start
```
## CLI example
```bash
echo '{
"query": [
"square pants"
],
"limit": 5
}' |
apify call jupri/pornhub --silent --output-dataset
```
## MCP server setup
```json
{
"mcpServers": {
"apify": {
"command": "npx",
"args": [
"mcp-remote",
"https://mcp.apify.com/?tools=jupri/pornhub",
"--header",
"Authorization: Bearer "
]
}
}
}
```
## OpenAPI specification
```json
{
"openapi": "3.0.1",
"info": {
"title": "PornHub Scraper",
"description": "💫 Scrape Pornhub.com Resources",
"version": "0.2",
"x-build-id": "9NGTJ10o5CjqmIkry"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/jupri~pornhub/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-jupri-pornhub",
"x-openai-isConsequential": false,
"summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
"tags": [
"Run Actor"
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/inputSchema"
}
}
}
},
"parameters": [
{
"name": "token",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "Enter your Apify token here"
}
],
"responses": {
"200": {
"description": "OK"
}
}
}
},
"/acts/jupri~pornhub/runs": {
"post": {
"operationId": "runs-sync-jupri-pornhub",
"x-openai-isConsequential": false,
"summary": "Executes an Actor and returns information about the initiated run in response.",
"tags": [
"Run Actor"
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/inputSchema"
}
}
}
},
"parameters": [
{
"name": "token",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "Enter your Apify token here"
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/runsResponseSchema"
}
}
}
}
}
}
},
"/acts/jupri~pornhub/run-sync": {
"post": {
"operationId": "run-sync-jupri-pornhub",
"x-openai-isConsequential": false,
"summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
"tags": [
"Run Actor"
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/inputSchema"
}
}
}
},
"parameters": [
{
"name": "token",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "Enter your Apify token here"
}
],
"responses": {
"200": {
"description": "OK"
}
}
}
}
},
"components": {
"schemas": {
"inputSchema": {
"type": "object",
"properties": {
"query": {
"title": "❓ Query",
"type": "array",
"description": "💡 List of Search KEYWORDS or URL",
"items": {
"type": "string"
}
},
"resource": {
"title": "🗂️ Resource Type",
"enum": [
"video",
"channel",
"actor"
],
"type": "string",
"description": "💡 Resource type for searching."
},
"limit": {
"title": "🔄 Limit",
"type": "integer",
"description": "Minimum number of search results"
},
"dev_proxy_config": {
"title": "🌐 PROXY NETWORKING",
"type": "object",
"description": "💡 Supported protocol:
HTTP(S), SOCKS5
{http|socks5}://{user:pass}@{hostname|ip-address}:port
Example: socks5://example.com:9000"
},
"dev_custom_headers": {
"title": "📜 HTTP HEADERS",
"type": "array",
"description": "💡 Additional HTTP Headers",
"items": {
"type": "object",
"required": [
"key",
"value"
],
"properties": {
"key": {
"type": "string",
"title": "Key"
},
"value": {
"type": "string",
"title": "Value"
}
}
}
},
"dev_custom_cookies": {
"title": "🍰 HTTP COOKIES",
"type": "array",
"description": "💡 Additional HTTP Cookies",
"items": {
"type": "object",
"required": [
"key",
"value"
],
"properties": {
"key": {
"type": "string",
"title": "Key"
},
"value": {
"type": "string",
"title": "Value"
}
}
}
},
"dev_transform_fields": {
"title": "♻️ CUSTOM FIELD",
"type": "array",
"description": "💡 Transform the resulting output. Select only needed fields.
For nested object use DOT. For example: address.streetAddress
For nested array use NUMBER (index of array element starting from index=0). For example: images.0.url
",
"items": {
"type": "object",
"required": [
"key",
"value"
],
"properties": {
"key": {
"type": "string",
"title": "Key"
},
"value": {
"type": "string",
"title": "Value"
}
}
}
},
"dev_dataset_name": {
"title": "📁 CUSTOM STORAGE",
"type": "string",
"description": "💡 Save results into custom named Dataset, use mask to customize dataset name
{ACTOR} = actor name
{DATE} = date (YYYYMMDD)
{TIME} = time (HHMMSS)
This masks can be used to autogenerate Dataset Name.
example: data-{DATE}
Depending on today date the dataset name will be: data-20230603
default: data-{ACTOR}-{DATE}-{TIME}"
},
"dev_dataset_clear": {
"title": "Clear Storage",
"type": "boolean",
"description": "Clear Dataset before insert/update."
},
"dev_no_strip": {
"title": "Disable data cleansing",
"type": "boolean",
"description": "💡 Keep/Save empty values (NULL, FALSE, empty ARRAY, empty OBJECT, empty STRING)"
}
}
},
"runsResponseSchema": {
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"actId": {
"type": "string"
},
"userId": {
"type": "string"
},
"startedAt": {
"type": "string",
"format": "date-time",
"example": "2025-01-08T00:00:00.000Z"
},
"finishedAt": {
"type": "string",
"format": "date-time",
"example": "2025-01-08T00:00:00.000Z"
},
"status": {
"type": "string",
"example": "READY"
},
"meta": {
"type": "object",
"properties": {
"origin": {
"type": "string",
"example": "API"
},
"userAgent": {
"type": "string"
}
}
},
"stats": {
"type": "object",
"properties": {
"inputBodyLen": {
"type": "integer",
"example": 2000
},
"rebootCount": {
"type": "integer",
"example": 0
},
"restartCount": {
"type": "integer",
"example": 0
},
"resurrectCount": {
"type": "integer",
"example": 0
},
"computeUnits": {
"type": "integer",
"example": 0
}
}
},
"options": {
"type": "object",
"properties": {
"build": {
"type": "string",
"example": "latest"
},
"timeoutSecs": {
"type": "integer",
"example": 300
},
"memoryMbytes": {
"type": "integer",
"example": 1024
},
"diskMbytes": {
"type": "integer",
"example": 2048
}
}
},
"buildId": {
"type": "string"
},
"defaultKeyValueStoreId": {
"type": "string"
},
"defaultDatasetId": {
"type": "string"
},
"defaultRequestQueueId": {
"type": "string"
},
"buildNumber": {
"type": "string",
"example": "1.0.0"
},
"containerUrl": {
"type": "string"
},
"usage": {
"type": "object",
"properties": {
"ACTOR_COMPUTE_UNITS": {
"type": "integer",
"example": 0
},
"DATASET_READS": {
"type": "integer",
"example": 0
},
"DATASET_WRITES": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_READS": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_WRITES": {
"type": "integer",
"example": 1
},
"KEY_VALUE_STORE_LISTS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_READS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_WRITES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_INTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_EXTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_SERPS": {
"type": "integer",
"example": 0
}
}
},
"usageTotalUsd": {
"type": "number",
"example": 0.00005
},
"usageUsd": {
"type": "object",
"properties": {
"ACTOR_COMPUTE_UNITS": {
"type": "integer",
"example": 0
},
"DATASET_READS": {
"type": "integer",
"example": 0
},
"DATASET_WRITES": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_READS": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_WRITES": {
"type": "number",
"example": 0.00005
},
"KEY_VALUE_STORE_LISTS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_READS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_WRITES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_INTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_EXTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_SERPS": {
"type": "integer",
"example": 0
}
}
}
}
}
}
}
}
}
}
```