{ "openapi": "3.0.1", "info": { "title": "xHamster Scraper", "description": "[💰 $2 / 1K] Extract public xHamster video metadata — title, tags, categories, duration, views, likes, rating, upload date, channel, thumbnail. Scrape by keyword search or paste video, search, category, tag, channel, and pornstar URLs. One flat row per video. No media/download links.", "version": "1.0", "x-build-id": "BOHzVr6mQfOJPslng" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/solidcode~xhamster-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-solidcode-xhamster-scraper", "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/solidcode~xhamster-scraper/runs": { "post": { "operationId": "runs-sync-solidcode-xhamster-scraper", "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/solidcode~xhamster-scraper/run-sync": { "post": { "operationId": "run-sync-solidcode-xhamster-scraper", "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": { "startUrls": { "title": "xHamster links", "type": "array", "description": "Paste one or more xHamster links. A single video link resolves to one result. A search, category, tag, channel, pornstar, or user page collects every video listed on it, page by page. You can mix different link types, and you can add keywords below as well.", "items": { "type": "string" } }, "searchQueries": { "title": "Keyword searches", "type": "array", "description": "Keywords to search for, such as a topic, a studio, or a performer name. Each keyword runs its own search and the matching videos are collected. Use this on its own or alongside the links above.", "items": { "type": "string" } }, "maxResults": { "title": "Maximum videos", "minimum": 0, "type": "integer", "description": "The most videos to collect in total, across every link and keyword search. Each video is one result. Set to 0 for no limit — runs then stop at a safety ceiling of 100,000 videos. Lower this to keep runs small and costs predictable." }, "maxResultsPerSource": { "title": "Maximum videos per link or search", "minimum": 0, "type": "integer", "description": "The most videos to take from any single search, category, tag, channel, pornstar, or user page. Some channels hold many thousands of videos, so this keeps each one in check. This is ignored for links that point at a single video. Set to 0 to remove this cap entirely — the overall maximum above still applies." }, "sortBy": { "title": "Sort order", "enum": [ "relevance", "newest", "views", "best", "longest" ], "type": "string", "description": "How to order the videos collected from searches and listing pages. Keyword searches support every option. Category, tag, channel and performer pages support Most Relevant, Newest First and Top Rated — the other options fall back to the page's own default order. This does not apply to links that point at a single video." }, "includeDetails": { "title": "Collect full details for each video", "type": "boolean", "description": "When on, each video's own page is opened to collect its tags, categories, performers, rating, comment count, and description. When off, the run is much faster and cheaper but each result carries only the title, link, duration, views, upload date, thumbnail, and uploader." } } }, "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 } } } } } } } } } }