{
  "openapi": "3.0.1",
  "info": {
    "title": "Pornhub, XVideos, XNXX & Chaturbate Scraper: Video & Cam Data",
    "description": "Scrape Pornhub, XVideos, XNXX and Chaturbate in one run: videos, video details, channels, pornstars, categories, keyword suggestions, live cam rooms and a live market snapshot. 80 fields, metadata only, no login. Export CSV, Excel, JSON or XML.",
    "version": "0.1",
    "x-build-id": "G9eiqveaeeywuKwMu"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/recordsdata~adult-video-cam-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-recordsdata-adult-video-cam-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/recordsdata~adult-video-cam-scraper/runs": {
      "post": {
        "operationId": "runs-sync-recordsdata-adult-video-cam-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/recordsdata~adult-video-cam-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-recordsdata-adult-video-cam-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": {
          "mode": {
            "title": "What to collect",
            "enum": [
              "videos",
              "videoDetails",
              "channels",
              "pornstars",
              "categories",
              "suggestions",
              "liveRooms",
              "liveRoomDetails",
              "liveSnapshot"
            ],
            "type": "string",
            "description": "Videos: search results and listings. Video details: one full page per video (likes, tags, performers). Channels, Pornstars, Categories: site rankings and tag lists. Search suggestions: keyword ideas from XVideos and XNXX. Live modes read Chaturbate: rooms on air now, one detailed row per room, or one market snapshot per segment.",
            "default": "videos"
          },
          "sites": {
            "title": "Sites to read",
            "type": "array",
            "description": "Pick the sites. Empty uses all four. Live modes use only Chaturbate. Search suggestions use only XVideos and XNXX. Channels are not available on XNXX.",
            "items": {
              "type": "string",
              "enum": [
                "pornhub",
                "xvideos",
                "xnxx",
                "chaturbate"
              ],
              "enumTitles": [
                "Pornhub",
                "XVideos",
                "XNXX",
                "Chaturbate"
              ]
            },
            "default": [
              "pornhub",
              "xvideos",
              "xnxx",
              "chaturbate"
            ]
          },
          "queries": {
            "title": "Search terms (optional)",
            "type": "array",
            "description": "Keywords, one per line; one search per term and site. Example: massage. In live modes a term filters room titles and tags; in pornstar, channel and category modes it filters the list by name. Empty reads the site rankings. Terms about minors are refused.",
            "items": {
              "type": "string"
            }
          },
          "startUrls": {
            "title": "Links to start from (optional)",
            "type": "array",
            "description": "Paste links copied from the sites instead of search terms: a search, category, video, channel, pornstar or Chaturbate room page. A video link returns that video; a channel or pornstar link returns its uploads in video modes and its profile otherwise.",
            "items": {
              "type": "object",
              "required": [
                "url"
              ],
              "properties": {
                "url": {
                  "type": "string",
                  "title": "URL of a web page",
                  "format": "uri"
                }
              }
            }
          },
          "maxItems": {
            "title": "Max rows to collect",
            "minimum": 1,
            "maximum": 1000000,
            "type": "integer",
            "description": "Stops after this many rows across all sites and terms. Example: 50. Free plan: capped at 10 rows (preview). Paid plans: up to 1,000,000.",
            "default": 10
          },
          "sortBy": {
            "title": "Sort videos by",
            "enum": [
              "relevance",
              "newest",
              "views",
              "rating",
              "longest"
            ],
            "type": "string",
            "description": "Best match keeps the site default. Newest, most viewed and top rated work on XVideos, and on Pornhub only without search terms. XNXX supports best match and most viewed. Longest works on XVideos only. Each row states the sort really applied.",
            "default": "relevance"
          },
          "period": {
            "title": "Time period",
            "enum": [
              "alltime",
              "today",
              "week",
              "month",
              "3months",
              "6months",
              "year"
            ],
            "type": "string",
            "description": "Period for the most viewed and top rated sorts and for upload date. Pornhub (no search terms): today to all time. XVideos: today to 6 months. XNXX: month, year.",
            "default": "alltime"
          },
          "duration": {
            "title": "Video length (minutes)",
            "enum": [
              "any",
              "10-20",
              "over-10",
              "over-20"
            ],
            "type": "string",
            "description": "Keep only videos of this length. Works on XVideos and XNXX searches; on Pornhub the length is checked on returned rows.",
            "default": "any"
          },
          "quality": {
            "title": "Video quality",
            "enum": [
              "any",
              "hd",
              "fullhd"
            ],
            "type": "string",
            "description": "Keep only HD or Full HD videos. Works on XVideos and XNXX.",
            "default": "any"
          },
          "producer": {
            "title": "Producer type",
            "enum": [
              "any",
              "professional",
              "homemade"
            ],
            "type": "string",
            "description": "Professional studios or homemade content. Works on Pornhub when no search terms are given.",
            "default": "any"
          },
          "liveGenders": {
            "title": "Cam category",
            "type": "array",
            "description": "Keep only rooms of these categories. Empty means all. The market snapshot mode always returns every category on its own row.",
            "items": {
              "type": "string",
              "enum": [
                "female",
                "male",
                "couple",
                "trans"
              ],
              "enumTitles": [
                "Female",
                "Male",
                "Couple",
                "Trans"
              ]
            },
            "default": []
          },
          "liveRegions": {
            "title": "Cam regions",
            "type": "array",
            "description": "Keep only rooms from these regions. Empty means all.",
            "items": {
              "type": "string",
              "enum": [
                "northAmerica",
                "southAmerica",
                "asia"
              ],
              "enumTitles": [
                "North America",
                "South America",
                "Asia"
              ]
            },
            "default": []
          },
          "liveTags": {
            "title": "Cam tags (optional)",
            "type": "array",
            "description": "Room tags without the # sign, one per line; one search per tag. Example: latina, lovense. Empty reads the whole room list. In market snapshot mode each tag becomes its own snapshot row.",
            "items": {
              "type": "string"
            }
          },
          "minViewers": {
            "title": "Min viewers (people watching now)",
            "minimum": 0,
            "type": "integer",
            "description": "Skip rooms with fewer viewers at run time. Example: 100. 0 keeps every room.",
            "default": 0
          },
          "enrichProfiles": {
            "title": "Open each profile page (channel and pornstar modes)",
            "type": "boolean",
            "description": "Adds exact totals, subscribers, country, description and badges. Adds one request per profile; turn off for a faster run with list columns only.",
            "default": true
          },
          "expandSuggestions": {
            "title": "Expand suggestions a to z (suggestions mode)",
            "type": "boolean",
            "description": "Repeats each seed word followed by every letter a to z to collect many more keyword ideas. Adds one request per letter.",
            "default": false
          },
          "includeThumbnails": {
            "title": "Include thumbnail links",
            "type": "boolean",
            "description": "Adds the thumbnail image link of each record. Turn off for leaner exports; some links expire after a day.",
            "default": true
          },
          "onlyNew": {
            "title": "Return only new records",
            "type": "boolean",
            "description": "Skips every record this same search already returned in an earlier run, so you are not charged for repeats. Max rows then means N new records. Off by default.",
            "default": false
          },
          "stateKey": {
            "title": "Monitor name (optional)",
            "type": "string",
            "description": "Label for the monitor memory. Use a different name per saved search, for example videos-weekly. Empty shares memory between runs of the same search.",
            "default": ""
          },
          "resetSeen": {
            "title": "Start over: forget records already seen",
            "type": "boolean",
            "description": "Clears the stored list for this search and monitor name before the run, so everything counts as new again.",
            "default": false
          }
        }
      },
      "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
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "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
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}