{ "openapi": "3.0.3", "info": { "title": "ca33e5be-5047-4db0-817b-cd1a9ef1fd12", "description": "", "version": "1.0.0", "contact": { "name": "", "email": "someone@youremail.com" } }, "servers": [ { "url": "https://api.adultdatalink.com" }, { "url": "https://echo.paw.cloud" }, { "url": "https://api.adultdatalink.comd" } ], "paths": { "/barelist/feed": { "get": { "tags": [ "barelist" ], "summary": "Feed", "description": "", "parameters": [], "responses": { "200": { "description": "" } }, "security": [], "operationId": "/barelist/feed" } }, "/pimpandhost/trending-images": { "get": { "tags": [ "pimpandhost" ], "summary": "Get Pimpandhost Trending Images", "description": "", "parameters": [], "responses": { "200": { "description": "" } }, "security": [], "operationId": "/pimpandhost/trending-images" } }, "/pornpics/tags": { "get": { "tags": [ "pornpics" ], "summary": "Get Pornpics Tags", "description": "Retrieves a dictionary of available tags from the PornPics tags configuration.\n\nThis endpoint reads the tags from the configuration file specified in `config.TAGS_FILE` and returns them as a \ndictionary where the keys are indices and the values are tag names.\n\nArgs:\n request (Request): The FastAPI request object for logging and context.\n\nReturns:\n dict: A dictionary mapping indices to tag names.\n Example:\n ```json\n {\n \"0\": \"tag1\",\n \"1\": \"tag2\",\n ...\n }\n ```\n\nRaises:\n HTTPException:\n - 500: If an error occurs while reading the tags file or processing the request.\n\nExample:\n ```bash\n curl \"http://api.adultdatalink.com/pornpics/tags\"\n ```\n\nNotes:\n - The tags are sourced from the `config.TAGS_FILE` configuration.\n - Errors are logged using the provided logger for debugging purposes.", "parameters": [], "responses": { "200": { "description": "" } }, "security": [], "operationId": "/pornpics/tags" } }, "/redtube/categories": { "get": { "tags": [ "redtube" ], "summary": "Retrieve list of video categories", "description": "Fetches a list of all video categories available on RedTube. Results are cached for performance.", "parameters": [], "responses": { "200": { "description": "" } }, "security": [], "operationId": "/redtube/categories" } }, "/redtube/tags": { "get": { "tags": [ "redtube" ], "summary": "Retrieve list of tags", "description": "Fetches a list of all tags used for categorizing videos on RedTube. Results are cached for performance.", "parameters": [], "responses": { "200": { "description": "" } }, "security": [], "operationId": "/redtube/tags" } }, "/redtube/stars": { "get": { "tags": [ "redtube" ], "summary": "Retrieve list of stars", "description": "Fetches a list of all stars (performers) on RedTube. Results are cached for performance.", "parameters": [], "responses": { "200": { "description": "" } }, "security": [], "operationId": "/redtube/stars" } }, "/redtube/stars-detailed": { "get": { "tags": [ "redtube" ], "summary": "Retrieve detailed list of stars", "description": "Fetches a detailed list of stars (performers) on RedTube, including additional metadata such as video count or profile details. Results are cached for performance.", "parameters": [], "responses": { "200": { "description": "" } }, "security": [], "operationId": "/redtube/stars-detailed" } }, "/sexstories/home": { "get": { "tags": [ "sexstories" ], "summary": "Get Sexstories Home", "description": "Retrieve the homepage content of the sex stories website.\n\nThis endpoint fetches the main page content, including featured stories, recent updates, or other highlighted sections.\n\nParameters:\n- request (Request): The FastAPI request object for logging and error handling.\n\n\nReturns:\n- Dict: A dictionary containing the homepage content (e.g., featured stories, sections).\n- None: If no content is retrieved.\n\nRaises:\n- HTTPException: \n - 500: If an error occurs during scraping or processing (e.g., network issues, parsing errors).\n\nExample:\n```\nGET /sexstories/home\nResponse:\n{\n \"featured\": [...],\n \"recent\": [...],\n \"sections\": {...}\n}\n```", "parameters": [], "responses": { "200": { "description": "" } }, "security": [], "operationId": "/sexstories/home" } }, "/sexstories/themes": { "get": { "tags": [ "sexstories" ], "summary": "Get Sexstories Themes", "description": "Retrieve the list of available story themes.\n\nThis endpoint returns a dictionary of theme IDs and their corresponding names, useful for filtering stories by category.\n\nParameters:\n- request (Request): The FastAPI request object for logging and error handling.\n\n\nReturns:\n- Dict: A dictionary mapping theme IDs to theme names (e.g., {\"1\": \"Alien\", \"2\": \"Anal\"}).\n- None: If no themes are retrieved.\n\nRaises:\n- HTTPException:\n - 500: If an error occurs during scraping or processing (e.g., network issues, parsing errors).\n\nExample:\n```\nGET /sexstories/themes\nResponse:\n{\n \"1\": \"Alien\",\n \"2\": \"Anal\",\n ...\n}\n```", "parameters": [], "responses": { "200": { "description": "" } }, "security": [], "operationId": "/sexstories/themes" } }, "/sexstories/genres": { "get": { "tags": [ "sexstories" ], "summary": "Get Sexstories Genres", "description": "Retrieve the list of available story genres.\n\nThis endpoint returns a dictionary of genre IDs and their corresponding names, useful for filtering stories by genre.\n\nParameters:\n- request (Request): The FastAPI request object for logging and error handling.\n\n\nReturns:\n- Dict: A dictionary mapping genre IDs to genre names (e.g., {\"1\": \"Fiction\", \"9\": \"Fantasy\"}).\n- None: If no genres are retrieved.\n\nRaises:\n- HTTPException:\n - 500: If an error occurs during scraping or processing (e.g., network issues, parsing errors).\n\nExample:\n```\nGET /sexstories/genres\nResponse:\n{\n \"1\": \"Fiction\",\n \"9\": \"Fantasy\",\n ...\n}\n```", "parameters": [], "responses": { "200": { "description": "" } }, "security": [], "operationId": "/sexstories/genres" } }, "/tnaflix/categories": { "get": { "tags": [ "tnaflix" ], "summary": "Get Tnaflix Categories", "description": "Retrieve a list of categories from TNAFlix.\n\nThis endpoint scrapes category data from the TNAFlix categories page, including\ntitle, image URL, views, and video count for each category.\n\nArgs:\n request (Request): The incoming HTTP request.\n tf_api (TnaflixApi): The TNAFlix API dependency for scraping.\n\nReturns:\n List[Dict[str, str]]: A list of dictionaries containing category details with the following keys:\n - title: Category title (e.g., 'VR Porn').\n - image: URL of the category thumbnail image.\n - views: Number of views for the category (e.g., '59.5K').\n - video_count: Number of videos in the category (e.g., '232').\n\nRaises:\n HTTPException: If an error occurs during scraping, returns a 400 status code with the error message.", "parameters": [], "responses": { "200": { "description": "" } }, "security": [], "operationId": "/tnaflix/categories" } }, "/": { "get": { "tags": [], "summary": "Root", "description": "", "parameters": [], "responses": { "200": { "description": "" } }, "security": [], "operationId": "/" } }, "/functions/download-video": { "get": { "tags": [ "functions" ], "summary": "Stream an MP4 file as a download", "description": "Streams an MP4 file from a provided URL directly to the client as a download. Requires API key authentication.", "parameters": [ { "name": "mp4_url", "in": "query", "description": "", "required": false, "schema": { "type": "string", "default": "", "description": "" } } ], "responses": { "200": { "description": "" } }, "security": [], "operationId": "/functions/download-video" } }, "/functions/stream-video": { "get": { "tags": [ "functions" ], "summary": "Stream Video", "description": "", "parameters": [ { "name": "url", "in": "query", "description": "", "required": false, "schema": { "type": "string", "default": "", "description": "" } } ], "responses": { "200": { "description": "" } }, "security": [], "operationId": "/functions/stream-video" } }, "/auntmia/scrape-gallery": { "get": { "tags": [ "auntmia" ], "summary": "Scrape Gallery Route", "description": "Scrape detailed information for a specific gallery using its URL.\n\nArgs:\n request (Request): The FastAPI request object.\n gallery_id (str): The URL or URL-compatible identifier of the gallery to scrape.\n am_api (AuntMiaApi): The API client for scraping auntmia.com.\n\nReturns:\n Dict: A dictionary containing detailed gallery information (site, title, model info,\n category info, tags, images, related content).\n\nRaises:\n HTTPException: If the gallery_id is invalid or an error occurs during scraping.", "parameters": [ { "name": "gallery_id", "in": "query", "description": "", "required": false, "schema": { "type": "string", "default": "", "description": "" } } ], "responses": { "200": { "description": "" } }, "security": [], "operationId": "/auntmia/scrape-gallery" } }, "/auntmia/search-by-model": { "get": { "tags": [ "auntmia" ], "summary": "Get Model Search", "description": "Search for galleries by model name and scrape detailed information for each gallery.\n\nArgs:\n request (Request): The FastAPI request object.\n model_name (Union[str, None]): The model name to search for (e.g., 'Aletta Ocean').\n\nReturns:\n List[Dict]: A list of dictionaries containing detailed gallery information.\n\nRaises:\n HTTPException: If the model name is invalid or an error occurs during scraping.", "parameters": [ { "name": "model_name", "in": "query", "description": "", "required": false, "schema": { "type": "string", "default": "", "description": "" } } ], "responses": { "200": { "description": "" } }, "security": [], "operationId": "/auntmia/search-by-model" } }, "/auntmia/search": { "get": { "tags": [ "auntmia" ], "summary": "Get Search", "description": "Search for galleries by query and scrape detailed information for each gallery.\n\nArgs:\n request (Request): The FastAPI request object.\n query (Union[str, None]): The search query (e.g., 'big boobs').\n\nReturns:\n List[Dict]: A list of dictionaries containing detailed gallery information.\n\nRaises:\n HTTPException: If the query is invalid or an error occurs during scraping.", "parameters": [ { "name": "query", "in": "query", "description": "", "required": false, "schema": { "type": "string", "default": "", "description": "" } } ], "responses": { "200": { "description": "" } }, "security": [], "operationId": "/auntmia/search" } }, "/eporner/search": { "get": { "tags": [ "eporner" ], "summary": "Get Eporner Search", "description": "Retrieves search results from a specified query.", "parameters": [ { "name": "query", "in": "query", "description": "", "required": false, "schema": { "type": "string", "default": "all", "description": "" } }, { "name": "per_page", "in": "query", "description": "", "required": false, "schema": { "type": "string", "default": "30", "description": "" } }, { "name": "page", "in": "query", "description": "", "required": false, "schema": { "type": "string", "default": "1", "description": "" } }, { "name": "thumbsize", "in": "query", "description": "", "required": false, "schema": { "type": "string", "default": "medium", "description": "" } }, { "name": "order", "in": "query", "description": "", "required": false, "schema": { "type": "string", "default": "latest", "description": "" } }, { "name": "gay", "in": "query", "description": "", "required": false, "schema": { "type": "string", "default": "", "description": "" } }, { "name": "lq", "in": "query", "description": "", "required": false, "schema": { "type": "string", "default": "1", "description": "" } }, { "name": "search_format", "in": "query", "description": "", "required": false, "schema": { "type": "string", "default": "json", "description": "" } } ], "responses": { "200": { "description": "" } }, "security": [], "operationId": "/eporner/search" } }, "/eporner/video": { "get": { "tags": [ "eporner" ], "summary": "Get Eporner Video By Id", "description": "Retrieves image links from a specified gallery.", "parameters": [ { "name": "video_id", "in": "query", "description": "", "required": false, "schema": { "type": "string", "default": "", "description": "" } }, { "name": "thumbsize", "in": "query", "description": "", "required": false, "schema": { "type": "string", "default": "medium", "description": "" } }, { "name": "search_format", "in": "query", "description": "", "required": false, "schema": { "type": "string", "default": "json", "description": "" } } ], "responses": { "200": { "description": "" } }, "security": [], "operationId": "/eporner/video" } }, "/eporner/model-information": { "get": { "tags": [ "eporner" ], "summary": "Get Eporner Model Information", "description": "Retrieves model information", "parameters": [ { "name": "model_name", "in": "query", "description": "", "required": false, "schema": { "type": "string", "default": "", "description": "" } } ], "responses": { "200": { "description": "" } }, "security": [], "operationId": "/eporner/model-information" } }, "/eporner/video-information": { "get": { "tags": [ "eporner" ], "summary": "Retrieve detailed information about a video", "description": "Fetches comprehensive metadata for a video from Eporner using either a video ID or URL. Includes details such as title, thumbnail, duration, resolution, uploader, views, likes, dislikes, comments, description, embed URL, raw MP4 URLs, download links, related content, and actors. Responses are cached to improve performance for repeated requests.", "parameters": [ { "name": "video_id", "in": "query", "description": "", "required": false, "schema": { "type": "string", "default": "", "description": "" } } ], "responses": { "200": { "description": "" } }, "security": [], "operationId": "/eporner/video-information" } }, "/erome/home": { "get": { "tags": [ "erome" ], "summary": "Retrieve album metadata from Erome homepage", "description": "Fetches a list of albums from the Erome homepage based on the specified feed type and page number. Includes metadata such as album link, title, thumbnail, user, user avatar, views, and video count. Responses are cached to improve performance for repeated requests.", "parameters": [ { "name": "feed_type", "in": "query", "description": "", "required": false, "schema": { "type": "string", "default": "hot", "description": "" } }, { "name": "page_number", "in": "query", "description": "", "required": false, "schema": { "type": "string", "default": "", "description": "" } } ], "responses": { "200": { "description": "" } }, "security": [], "operationId": "/erome/home" } }, "/erome/album": { "get": { "tags": [ "erome" ], "summary": "Retrieve detailed metadata from an Erome album", "description": "Fetches detailed metadata for a specific Erome album using the album ID. Includes title, user, user avatar, views, likes, reposts, comments (username and text), video source URLs, and more posts (album link, title, username, thumbnail, video count). Responses are cached to improve performance for repeated requests.", "parameters": [ { "name": "album_id", "in": "query", "description": "", "required": false, "schema": { "type": "string", "default": "https://www.erome.com/a/1Yym14jI", "description": "" } } ], "responses": { "200": { "description": "" } }, "security": [], "operationId": "/erome/album" } }, "/erome/search": { "get": { "tags": [ "erome" ], "summary": "Retrieve album metadata from Erome search results", "description": "Fetches a list of albums from Erome search results based on the specified query, order, and page number. Includes metadata such as album link, title, thumbnail, user, user avatar, views, video count, and image count. Responses are cached to improve performance for repeated requests.", "parameters": [ { "name": "query", "in": "query", "description": "", "required": false, "schema": { "type": "string", "default": "", "description": "" } }, { "name": "order", "in": "query", "description": "", "required": false, "schema": { "type": "string", "default": "hot", "description": "" } }, { "name": "page_number", "in": "query", "description": "", "required": false, "schema": { "type": "string", "default": "", "description": "" } } ], "responses": { "200": { "description": "" } }, "security": [], "operationId": "/erome/search" } }, "/erome/user": { "get": { "tags": [ "erome" ], "summary": "Retrieve user profile metadata from Erome", "description": "Fetches metadata for a specific Erome user profile, including username, avatar, post count, view count, follower count, bio, and a list of posts. Supports pagination for posts via the max_pages parameter. Responses are cached to improve performance for repeated requests.", "parameters": [ { "name": "username", "in": "query", "description": "", "required": false, "schema": { "type": "string", "default": "", "description": "" } }, { "name": "max_pages", "in": "query", "description": "", "required": false, "schema": { "type": "string", "default": "1", "description": "" } } ], "responses": { "200": { "description": "" } }, "security": [], "operationId": "/erome/user" } }, "/freeones/model-information": { "get": { "tags": [ "freeones" ], "summary": "Get Model Information", "description": "", "parameters": [ { "name": "model_name", "in": "query", "description": "", "required": false, "schema": { "type": "string", "default": "", "description": "" } } ], "responses": { "200": { "description": "" } }, "security": [], "operationId": "/freeones/model-information" } }, "/letsjerktv/feed": { "get": { "tags": [ "letsjerktv" ], "summary": "Get Letsjerktv Feed", "description": "", "parameters": [ { "name": "page", "in": "query", "description": "", "required": false, "schema": { "type": "string", "default": "1", "description": "" } } ], "responses": { "200": { "description": "" } }, "security": [], "operationId": "/letsjerktv/feed" } }, "/letsjerktv/categories": { "get": { "tags": [ "letsjerktv" ], "summary": "Get Letsjerktv Categories", "description": "", "parameters": [ { "name": "page", "in": "query", "description": "", "required": false, "schema": { "type": "string", "default": "1", "description": "" } } ], "responses": { "200": { "description": "" } }, "security": [], "operationId": "/letsjerktv/categories" } }, "/letsjerktv/category-videos": { "get": { "tags": [ "letsjerktv" ], "summary": "Get Letsjerktv Category Videos", "description": "", "parameters": [ { "name": "category", "in": "query", "description": "", "required": false, "schema": { "type": "string", "default": "", "description": "" } }, { "name": "page", "in": "query", "description": "", "required": false, "schema": { "type": "string", "default": "1", "description": "" } } ], "responses": { "200": { "description": "" } }, "security": [], "operationId": "/letsjerktv/category-videos" } }, "/letsjerktv/video-information": { "get": { "tags": [ "letsjerktv", "Video Information" ], "summary": "Retrieve detailed information about a specific LetsJerk.tv video", "description": "Fetches comprehensive metadata for a given LetsJerk.tv video URL. The endpoint scrapes details such as the video title, embed URL, download URL, thumbnail, tags, categories, and related videos. Results are cached to improve performance for repeated requests.\n \n **Note**: The provided URL must be a valid LetsJerk.tv video URL. Invalid URLs will result in a 400 error.", "parameters": [ { "name": "video_url", "in": "query", "description": "", "required": false, "schema": { "type": "string", "default": "", "description": "" } } ], "responses": { "200": { "description": "" } }, "security": [], "operationId": "/letsjerktv/video-information" } }, "/letsjerktv/pornstars": { "get": { "tags": [ "letsjerktv" ], "summary": "Get Letsjerktv Pornstars", "description": "", "parameters": [ { "name": "page", "in": "query", "description": "", "required": false, "schema": { "type": "string", "default": "1", "description": "" } } ], "responses": { "200": { "description": "" } }, "security": [], "operationId": "/letsjerktv/pornstars" } }, "/letsjerktv/pornstar-videos": { "get": { "tags": [ "letsjerktv" ], "summary": "Get Letsjerktv Pornstar Videos", "description": "", "parameters": [ { "name": "pornstar_url", "in": "query", "description": "", "required": false, "schema": { "type": "string", "default": "", "description": "" } }, { "name": "page", "in": "query", "description": "", "required": false, "schema": { "type": "string", "default": "1", "description": "" } } ], "responses": { "200": { "description": "" } }, "security": [], "operationId": "/letsjerktv/pornstar-videos" } }, "/letsjerktv/search": { "get": { "tags": [ "letsjerktv" ], "summary": "Search Letsjerktv Videos", "description": "", "parameters": [ { "name": "query", "in": "query", "description": "", "required": false, "schema": { "type": "string", "default": "", "description": "" } }, { "name": "page", "in": "query", "description": "", "required": false, "schema": { "type": "string", "default": "1", "description": "" } } ], "responses": { "200": { "description": "" } }, "security": [], "operationId": "/letsjerktv/search" } }, "/pimpandhost/categories": { "get": { "tags": [ "pimpandhost" ], "summary": "Get Pimpandhost Tags", "description": "", "parameters": [ { "name": "filter_", "in": "query", "description": "", "required": false, "schema": { "type": "string", "default": "", "description": "" } } ], "responses": { "200": { "description": "" } }, "security": [], "operationId": "/pimpandhost/categories" } }, "/pimpandhost/pornstars": { "get": { "tags": [ "pimpandhost" ], "summary": "Get Pimpandhost Pornstars", "description": "", "parameters": [ { "name": "filter_", "in": "query", "description": "", "required": false, "schema": { "type": "string", "default": "", "description": "" } } ], "responses": { "200": { "description": "" } }, "security": [], "operationId": "/pimpandhost/pornstars" } }, "/pimpandhost/gifs": { "get": { "tags": [ "pimpandhost" ], "summary": "Get Pimpandhost Gifs", "description": "", "parameters": [ { "name": "page", "in": "query", "description": "", "required": false, "schema": { "type": "string", "default": "10", "description": "" } }, { "name": "per_page", "in": "query", "description": "", "required": false, "schema": { "type": "string", "default": "1", "description": "" } } ], "responses": { "200": { "description": "" } }, "security": [], "operationId": "/pimpandhost/gifs" } }, "/pimpandhost/category-media": { "get": { "tags": [ "pimpandhost" ], "summary": "Get Pimpandhost Category Media", "description": "", "parameters": [ { "name": "category", "in": "query", "description": "", "required": false, "schema": { "type": "string", "default": "", "description": "" } }, { "name": "page", "in": "query", "description": "", "required": false, "schema": { "type": "string", "default": "10", "description": "" } }, { "name": "per_page", "in": "query", "description": "", "required": false, "schema": { "type": "string", "default": "1", "description": "" } } ], "responses": { "200": { "description": "" } }, "security": [], "operationId": "/pimpandhost/category-media" } }, "/pimpandhost/pornstar-media": { "get": { "tags": [ "pimpandhost" ], "summary": "Get Pimpandhost Pornstar Media", "description": "", "parameters": [ { "name": "pornstar", "in": "query", "description": "", "required": false, "schema": { "type": "string", "default": "", "description": "" } }, { "name": "page", "in": "query", "description": "", "required": false, "schema": { "type": "string", "default": "10", "description": "" } }, { "name": "per_page", "in": "query", "description": "", "required": false, "schema": { "type": "string", "default": "1", "description": "" } } ], "responses": { "200": { "description": "" } }, "security": [], "operationId": "/pimpandhost/pornstar-media" } }, "/pornhub/get-video-by-id": { "get": { "tags": [ "pornhub" ], "summary": "Get Video By Id", "description": "Retrieve detailed information about a specific video by its ID.\n\nThis endpoint fetches comprehensive details for a video specified by its unique video ID.\nReturns a JSON object containing video information or null if the video is not found.\n\nArgs:\n video_id (str): The unique identifier of the video (required). Typically in the format 'phxxxxxxxxxxxxxx'\n\nReturns:\n Dict: JSON response containing:\n - video: Object with video details or null if not found, containing:\n - title: Video title\n - duration: Length in MM:SS format\n - views: Number of views\n - video_id: Unique video identifier\n - rating: Rating percentage\n - ratings: Number of ratings\n - url: Video URL\n - default_thumb: Default thumbnail URL\n - thumb: Primary thumbnail URL\n - publish_date: ISO format publication date (e.g., \"2015-10-05T10:30:08\")\n - segment: Video segment (e.g., 'straight')\n - thumbs: List of thumbnail objects (size, width, height, src)\n - tags: List of tag names\n - categories: List of category names\n - pornstars: List of pornstar names\n\nRaises:\n HTTPException: 400 if the video_id is invalid or empty\n HTTPException: 500 if there's an internal server error\n\nExample:\n GET /get-video-by-id?video_id=ph560b93077ddae", "parameters": [ { "name": "video_id", "in": "query", "description": "", "required": false, "schema": { "type": "string", "default": "", "description": "" } } ], "responses": { "200": { "description": "" } }, "security": [], "operationId": "/pornhub/get-video-by-id" } }, "/pornhub/search": { "get": { "tags": [ "pornhub" ], "summary": "Search", "description": "Search for videos with various filtering options.\n\nThis endpoint allows searching for videos using multiple parameters to filter and sort results.\nReturns a JSON object containing an array of video objects under the 'videos' key.\n\nArgs:\n q (str): The search term to look for (required)\n page (int, optional): Page number for paginated results\n ordering (str, optional): How to sort the results. Options:\n - 'featured': Featured videos\n - 'newest': Most recent videos\n - 'mostviewed': Most viewed videos\n - 'rating': Highest rated videos\n thumbsize (str, optional): Size of returned thumbnails. Options:\n - 'small': Small size\n - 'medium': Medium size\n - 'large': Large size\n - 'small_hd': Small HD\n - 'medium_hd': Medium HD\n - 'large_hd': Large HD\n category (str, optional): Filter by specific category\n phrase (List[str], optional): Filter by specific pornstars\n tags (List[str], optional): Filter by specific tags\n period (str, optional): Time period for ordered results. Options:\n - 'weekly': Last week\n - 'monthly': Last month\n - 'alltime': All time\n\nReturns:\n Dict: JSON response containing:\n - videos: List of video objects, each containing:\n - title: Video title\n - duration: Length in MM:SS format\n - views: Number of views\n - video_id: Unique video identifier\n - rating: Rating percentage\n - ratings: Number of ratings\n - url: Video URL\n - default_thumb: Default thumbnail URL\n - thumb: Primary thumbnail URL\n - publish_date: ISO format publication date\n - segment: Video segment\n - thumbs: List of thumbnail objects (size, width, height, src)\n - tags: List of tag names\n - categories: List of category names\n - pornstars: List of pornstar names\n\nRaises:\n HTTPException: 400 if invalid parameter values are provided\n HTTPException: 500 if there's an internal server error\n\nExample:\n GET /search?q=test&ordering=mostviewed&period=weekly&tags=[\"tag1\"]", "parameters": [ { "name": "q", "in": "query", "description": "", "required": false, "schema": { "type": "string", "default": "", "description": "" } }, { "name": "page", "in": "query", "description": "", "required": false, "schema": { "type": "string", "default": "", "description": "" } }, { "name": "ordering", "in": "query", "description": "", "required": false, "schema": { "type": "string", "default": "featured", "description": "" } }, { "name": "thumbsize", "in": "query", "description": "", "required": false, "schema": { "type": "string", "default": "small", "description": "" } }, { "name": "category", "in": "query", "description": "", "required": false, "schema": { "type": "string", "default": "", "description": "" } }, { "name": "phrase", "in": "query", "description": "", "required": false, "schema": { "type": "string", "default": "", "description": "" } }, { "name": "tags", "in": "query", "description": "", "required": false, "schema": { "type": "string", "default": "", "description": "" } }, { "name": "period", "in": "query", "description": "", "required": false, "schema": { "type": "string", "default": "weekly", "description": "" } } ], "responses": { "200": { "description": "" } }, "security": [], "operationId": "/pornhub/search" } }, "/pornpics/tag-image-links": { "get": { "tags": [ "pornpics" ], "summary": "Get Pornpics Image Links", "description": "Retrieves direct image URLs for a specified PornPics tag.\n\nThe tag must be a valid PornPics tag as defined in the tags configuration.\n\nArgs:\n request (Request): The FastAPI request object for logging and context.\n tag (Union[str, None], optional): The tag to search for (e.g., \"blonde\"). Must be a valid PornPics tag. \n Defaults to None.\nReturns:\n dict: A dictionary containing a list of image URLs.\n Example:\n ```json\n {\n \"urls\": [\n \"https://example.com/image1.jpg\",\n \"https://example.com/image2.jpg\"\n ]\n }\n ```\n\nRaises:\n HTTPException:\n - 422: If the `tag` parameter is missing or empty.\n - 404: If no image links are found for the provided tag.\n - 400: If an unexpected error occurs during the scraping process.\n\nExample:\n ```bash\n curl \"http://api.adultdatalink.com/pornpics/tag-image-links?tag=blonde\"\n ```\n\nNotes:\n - The `tag` must be a valid tag as defined in the tags configuration.\n - Errors are logged using the provided logger for debugging purposes.", "parameters": [ { "name": "tag", "in": "query", "description": "", "required": false, "schema": { "type": "string", "default": "", "description": "" } } ], "responses": { "200": { "description": "" } }, "security": [], "operationId": "/pornpics/tag-image-links" } }, "/pornpics/gallery-image-links": { "get": { "tags": [ "pornpics" ], "summary": "Get Pornpics Gallery Links", "description": "Retrieves direct image URLs from a specified PornPics gallery page.\n\nThis endpoint scrapes a given PornPics gallery URL to extract and return a list of direct image links. \n\nArgs:\n request (Request): The FastAPI request object for logging and context.\n gallery (Union[str, None], optional): The full URL of the PornPics gallery to scrape \n (e.g., \"https://www.pornpics.com/galleries/tall-woman-alexis-fawx-flashes-upskirt-panties-before-stripping-naked-55377150/\"). \n Must be a valid PornPics gallery URL. Defaults to None.\n\nReturns:\n dict: A dictionary containing a list of image URLs.\n Example:\n ```json\n {\n \"urls\": [\n \"https://example.com/image1.jpg\",\n \"https://example.com/image2.jpg\"\n ]\n }\n ```\n\nRaises:\n HTTPException:\n - 422: If the `gallery` parameter is missing or empty.\n - 404: If no image links are found for the provided gallery URL.\n - 400: If an unexpected error occurs during the scraping process.\n\nExample:\n ```bash\n curl \"http://api.adultdatalink.com/pornpics/gallery-image-links?gallery=https://www.pornpics.com/galleries/tall-woman-alexis-fawx-flashes-upskirt-panties-before-stripping-naked-55377150/\"\n ```\n\nNotes:\n - The `gallery` URL must be a valid PornPics gallery page.\n - Errors are logged using the provided logger for debugging purposes.", "parameters": [ { "name": "gallery", "in": "query", "description": "", "required": false, "schema": { "type": "string", "default": "", "description": "" } } ], "responses": { "200": { "description": "" } }, "security": [], "operationId": "/pornpics/gallery-image-links" } }, "/pornpics/search": { "get": { "tags": [ "pornpics" ], "summary": "Search Pornpics", "description": "Searches PornPics for galleries based on a query string.\nThis endpoint performs a search on PornPics using the provided query string and returns a list of gallery results in JSON format.\n\nArgs:\n request (Request): The FastAPI request object for logging and context.\n query (Union[str, None], optional): The search query string (e.g., \"blonde milf\"). Must be a valid search term. \n Defaults to None.\n\nReturns:\n dict: A JSON-compatible dictionary containing the search results.\n Example:\n ```json\n {\n \"results\": [\n {\n \"gallery_url\": \"https://www.pornpics.com/galleries/...\",\n \"title\": \"Gallery Title\",\n ...\n }\n ]\n }\n ```\n\nRaises:\n HTTPException:\n - 422: If the `query` parameter is missing, empty, or invalid (e.g., URLs or bytecode).\n - 404: If no results are found for the provided query.\n - 400: If an unexpected error occurs during the search process.\n\nExample:\n ```bash\n curl \"http://api.adultdatalink.com/pornpics/search?query=blonde+milf\"\n ```\n\nNotes:\n - The `query` must be a valid search term (alphanumeric, spaces, and common punctuation allowed).\n - URLs, bytecode, or other invalid inputs are rejected.\n - The response is always JSON-formatted.\n - Errors are logged using the provided logger for debugging purposes.", "parameters": [ { "name": "query", "in": "query", "description": "", "required": false, "schema": { "type": "string", "default": "", "description": "" } } ], "responses": { "200": { "description": "" } }, "security": [], "operationId": "/pornpics/search" } }, "/pornstar/social-profiles": { "get": { "tags": [ "pornstar" ], "summary": "Get Social Profiles", "description": "", "parameters": [ { "name": "name", "in": "query", "description": "", "required": false, "schema": { "type": "string", "default": "", "description": "" } } ], "responses": { "200": { "description": "" } }, "security": [], "operationId": "/pornstar/social-profiles" } }, "/pornstar/pornstar-data": { "get": { "tags": [ "pornstar", "Pornstar Data" ], "summary": "Retrieve pornstar biography data", "description": "Fetches detailed biography data for a specified pornstar using the Freeones API. The endpoint supports caching to optimize performance for repeated queries. If the requested pornstar is not found or an error occurs, an appropriate HTTP exception is raised. This endpoint requires a valid pornstar name to be provided as a query parameter.", "parameters": [ { "name": "name", "in": "query", "description": "", "required": false, "schema": { "type": "string", "default": "", "description": "" } } ], "responses": { "200": { "description": "" } }, "security": [], "operationId": "/pornstar/pornstar-data" } }, "/pornstar/search-model-by-features": { "get": { "tags": [ "pornstar" ], "summary": "Search pornstars by physical and demographic features", "description": "Search for pornstars by physical and demographic characteristics.\n\nThis endpoint allows you to filter pornstar profiles based on a wide range of attributes such as age,\nphysical features, and origin. It's designed to help you explore and discover models that match\nspecific criteria.\n\n### Available Query Parameters\n\n- **year1** (str, optional): Minimum birth year of the pornstar.\n- **year2** (str, optional): Maximum birth year of the pornstar.\n- **eyes** (str, optional): Eye color. Example values: `blue`, `green`, `brown`, `hazel`.\n- **hair** (str, optional): Hair color. Example values: `blonde`, `black`, `red`, `brunette`.\n- **ethnicity** (str, optional): Ethnic background. Example values: `white`, `asian`, `black`, `latina`.\n- **country** (str, optional): Country of origin or residence. Use full country names like `USA`, `Germany`, etc.\n- **height1** (str, optional): Minimum height in centimeters.\n- **height2** (str, optional): Maximum height in centimeters.\n- **weight1** (str, optional): Minimum weight in kilograms.\n- **weight2** (str, optional): Maximum weight in kilograms.\n- **boobs** (str, optional): Boob size category. Example values: `small`, `medium`, `big`.\n\n### Example Usage\n\nTo find blonde pornstars from the USA with blue eyes and medium breasts:\n```\n/search-model-by-features?hair=blonde&country=USA&eyes=blue&boobs=medium\n```\n\nTo search for petite Asian models under 160 cm and 50 kg:\n```\n/search-model-by-features?ethnicity=asian&height2=160&weight2=50\n```\n\n### Response\n\nReturns a JSON object with the following structure:\n```json\n{\n \"results\": [\n {\n \"name\": \"Jane Doe\",\n \"url\": \"https://example.com/model/jane-doe\",\n \"thumbnail\": \"https://example.com/img/jane.jpg\",\n \"aliases\": \"Janie D\",\n \"country\": \"USA\",\n \"ethnicity\": \"White\",\n \"birthday\": \"1992-06-01\",\n \"eyes\": \"Blue\",\n \"hair\": \"Blonde\",\n \"height\": \"170 cm\",\n \"weight\": \"55 kg\",\n \"measurements\": \"34C-24-36\",\n \"cup\": \"C\",\n \"last_update\": \"2024-11-20\",\n \"videos\": \"25\",\n \"galleries\": \"12\"\n }\n ],\n \"code\": 200\n}\n```\n\n### Notes\n\n- All parameters are optional. Providing more filters narrows the search results.\n- The response is cached for performance. Repeating the same query returns cached results if available.\n- The endpoint supports real-time scraping, so results may vary based on live site data availability.", "parameters": [ { "name": "year1", "in": "query", "description": "", "required": false, "schema": { "type": "string", "default": "", "description": "" } }, { "name": "year2", "in": "query", "description": "", "required": false, "schema": { "type": "string", "default": "", "description": "" } }, { "name": "eyes", "in": "query", "description": "", "required": false, "schema": { "type": "string", "default": "", "description": "" } }, { "name": "hair", "in": "query", "description": "", "required": false, "schema": { "type": "string", "default": "", "description": "" } }, { "name": "ethnicity", "in": "query", "description": "", "required": false, "schema": { "type": "string", "default": "", "description": "" } }, { "name": "country", "in": "query", "description": "", "required": false, "schema": { "type": "string", "default": "", "description": "" } }, { "name": "height1", "in": "query", "description": "", "required": false, "schema": { "type": "string", "default": "", "description": "" } }, { "name": "height2", "in": "query", "description": "", "required": false, "schema": { "type": "string", "default": "", "description": "" } }, { "name": "weight1", "in": "query", "description": "", "required": false, "schema": { "type": "string", "default": "", "description": "" } }, { "name": "weight2", "in": "query", "description": "", "required": false, "schema": { "type": "string", "default": "", "description": "" } }, { "name": "boobs", "in": "query", "description": "", "required": false, "schema": { "type": "string", "default": "", "description": "" } } ], "responses": { "200": { "description": "" } }, "security": [], "operationId": "/pornstar/search-model-by-features" } }, "/redgifs/feed": { "get": { "tags": [ "redgifs" ], "summary": "Retrieve top weekly RedGifs content", "description": "Retrieves the 'Top This Week' feed from RedGifs with optional filters for media type, count, and page.\n Returns a list of media metadata (GIFs or images) based on the specified parameters.\n\n **Parameters**:\n - **count**: Number of results to return (1-100). Defaults to 30.\n - **page**: Page number to retrieve (positive integer). Defaults to 1.\n - **media_type**: Media type to retrieve ('g' for GIFs, 'i' for images). Defaults to 'g'.\n\n **Returns**:\n - A dictionary containing the media type and a list of media metadata objects with details such as ID, title, URLs, and duration.\n\n **Raises**:\n - **HTTPException (422)**: If invalid parameters are provided.\n - **HTTPException (400)**: If an error occurs during retrieval.", "parameters": [ { "name": "count", "in": "query", "description": "", "required": false, "schema": { "type": "string", "default": "30", "description": "" } }, { "name": "page", "in": "query", "description": "", "required": false, "schema": { "type": "string", "default": "1", "description": "" } }, { "name": "media_type", "in": "query", "description": "", "required": false, "schema": { "type": "string", "default": "g", "description": "" } } ], "responses": { "200": { "description": "" } }, "security": [], "operationId": "/redgifs/feed" } }, "/redgifs/trending": { "get": { "tags": [ "redgifs" ], "summary": "Retrieve trending RedGifs content", "description": "Retrieves trending content from RedGifs, such as tags, GIFs, or images, based on the specified parameter.\n\n **Parameters**:\n - **parameter**: Type of trending content ('tags', 'gif', or 'image'). Required.\n\n **Returns**:\n - A dictionary containing the parameter and a list of trending items (tags or media metadata).\n\n **Raises**:\n - **HTTPException (422)**: If the parameter is invalid or missing.\n - **HTTPException (400)**: If an error occurs during retrieval.", "parameters": [ { "name": "parameter", "in": "query", "description": "", "required": false, "schema": { "type": "string", "default": "", "description": "" } } ], "responses": { "200": { "description": "" } }, "security": [], "operationId": "/redgifs/trending" } }, "/redgifs/gif": { "get": { "tags": [ "redgifs" ], "summary": "Retrieve a specific RedGifs GIF", "description": "Retrieves details of a specific GIF by its ID.\n\n **Parameters**:\n - **gif_id**: Unique ID of the GIF (e.g., 'abcxyz' from 'https://redgifs.com/watch/abcxyz'). Required.\n\n **Returns**:\n - A dictionary containing the GIF's metadata, including ID, title, URLs, and duration.\n\n **Raises**:\n - **HTTPException (404)**: If the GIF is not found.\n - **HTTPException (400)**: If an error occurs during retrieval.", "parameters": [ { "name": "gif_id", "in": "query", "description": "", "required": false, "schema": { "type": "string", "default": "", "description": "" } } ], "responses": { "200": { "description": "" } }, "security": [], "operationId": "/redgifs/gif" } }, "/redgifs/tags": { "get": { "tags": [ "redgifs" ], "summary": "Retrieve RedGifs tags", "description": "Retrieves a list of tags from RedGifs, either trending or all available tags.\n\n **Parameters**:\n - **trending**: If True, returns trending tags sorted by count; otherwise, all tags. Defaults to False.\n\n **Returns**:\n - A dictionary containing a list of tag objects with name and count.\n\n **Raises**:\n - **HTTPException (400)**: If an error occurs during retrieval.", "parameters": [ { "name": "trending", "in": "query", "description": "", "required": false, "schema": { "type": "string", "default": "", "description": "" } } ], "responses": { "200": { "description": "" } }, "security": [], "operationId": "/redgifs/tags" } }, "/redgifs/creator": { "get": { "tags": [ "redgifs" ], "summary": "Retrieve a RedGifs creator's profile", "description": "Retrieves a RedGifs creator's profile and content by username, with optional filters for count, page, order, and media type.\n\n **Parameters**:\n - **username**: Creator's username. Required.\n - **count**: Number of results to return (1-100). Defaults to 10.\n - **page**: Page number to retrieve (positive integer). Defaults to 1.\n - **order**: Sorting order: 'TRENDING', 'TOP', 'LATEST', 'OLDEST', 'RECENT', 'BEST', 'TOP28', 'NEW'. Defaults to 'RECENT'.\n - **media_type**: Media type: 'g' for GIFs, 'i' for images. Defaults to 'g'.\n\n **Returns**:\n - A dictionary containing the creator's profile and content metadata.\n\n **Raises**:\n - **HTTPException (404)**: If the creator is not found.\n - **HTTPException (400)**: If an error occurs during retrieval.", "parameters": [ { "name": "username", "in": "query", "description": "", "required": false, "schema": { "type": "string", "default": "", "description": "" } }, { "name": "count", "in": "query", "description": "", "required": false, "schema": { "type": "string", "default": "10", "description": "" } }, { "name": "page", "in": "query", "description": "", "required": false, "schema": { "type": "string", "default": "1", "description": "" } }, { "name": "order", "in": "query", "description": "", "required": false, "schema": { "type": "string", "default": "recent", "description": "" } }, { "name": "media_type", "in": "query", "description": "", "required": false, "schema": { "type": "string", "default": "g", "description": "" } } ], "responses": { "200": { "description": "" } }, "security": [], "operationId": "/redgifs/creator" } }, "/redgifs/search": { "get": { "tags": [ "redgifs" ], "summary": "Search for RedGifs media", "description": "Searches RedGifs for GIFs or images based on a query string, with optional filters for media type, count, page, and order.\n\n **Parameters**:\n - **media_type**: Media type to search ('gif' or 'image'). Required.\n - **search_text**: Search query text (e.g., 'funny'). Required.\n - **count**: Number of results to return (1-100). Defaults to 10.\n - **page**: Page number to retrieve (positive integer). Defaults to 1.\n - **order**: Sorting order: 'TRENDING', 'TOP', 'LATEST', 'OLDEST', 'RECENT', 'BEST', 'TOP28', 'NEW'. Defaults to 'TRENDING'.\n\n **Returns**:\n - A dictionary containing the search text, media type, and a list of media metadata.\n\n **Raises**:\n - **HTTPException (422)**: If media_type or search_text is invalid.\n - **HTTPException (500)**: If the API returns an error.\n - **HTTPException (400)**: If an error occurs during retrieval.", "parameters": [ { "name": "media_type", "in": "query", "description": "", "required": false, "schema": { "type": "string", "default": "", "description": "" } }, { "name": "search_text", "in": "query", "description": "", "required": false, "schema": { "type": "string", "default": "", "description": "" } }, { "name": "count", "in": "query", "description": "", "required": false, "schema": { "type": "string", "default": "10", "description": "" } }, { "name": "page", "in": "query", "description": "", "required": false, "schema": { "type": "string", "default": "1", "description": "" } }, { "name": "order", "in": "query", "description": "", "required": false, "schema": { "type": "string", "default": "trending", "description": "" } } ], "responses": { "200": { "description": "" } }, "security": [], "operationId": "/redgifs/search" } }, "/redgifs/tag-suggestions": { "get": { "tags": [ "redgifs" ], "summary": "Retrieve RedGifs tag suggestions", "description": "Retrieves tag suggestions from RedGifs based on a query string.\n\n **Parameters**:\n - **query**: Tag query to generate suggestions (e.g., 'fun'). Required.\n\n **Returns**:\n - A dictionary containing a list of tag suggestion objects with name and count.\n\n **Raises**:\n - **HTTPException (422)**: If the query is missing.\n - **HTTPException (400)**: If an error occurs during retrieval.", "parameters": [ { "name": "query", "in": "query", "description": "", "required": false, "schema": { "type": "string", "default": "", "description": "" } } ], "responses": { "200": { "description": "" } }, "security": [], "operationId": "/redgifs/tag-suggestions" } }, "/redgifs/creators": { "get": { "tags": [ "redgifs" ], "summary": "Retrieve a list of RedGifs creators", "description": "Retrieves a list of RedGifs creators with optional filters for page, count, order, verified status, and tags.\n\n **Parameters**:\n - **page**: Page number to retrieve (positive integer). Defaults to 1.\n - **count**: Number of results to return (1-100). Defaults to 10.\n - **order**: Sorting order: 'TRENDING', 'TOP', 'LATEST', 'OLDEST', 'RECENT', 'BEST', 'TOP28', 'NEW'. Defaults to 'RECENT'.\n - **verified**: If True, returns only verified creators. Defaults to False.\n - **tags**: Optional list of tags to filter creators by content.\n\n **Returns**:\n - A dictionary containing a list of creator metadata objects.\n\n **Raises**:\n - **HTTPException (400)**: If an error occurs during retrieval.", "parameters": [ { "name": "page", "in": "query", "description": "", "required": false, "schema": { "type": "string", "default": "1", "description": "" } }, { "name": "count", "in": "query", "description": "", "required": false, "schema": { "type": "string", "default": "10", "description": "" } }, { "name": "order", "in": "query", "description": "", "required": false, "schema": { "type": "string", "default": "recent", "description": "" } }, { "name": "verified", "in": "query", "description": "", "required": false, "schema": { "type": "string", "default": "", "description": "" } }, { "name": "tags", "in": "query", "description": "", "required": false, "schema": { "type": "string", "default": "", "description": "" } } ], "responses": { "200": { "description": "" } }, "security": [], "operationId": "/redgifs/creators" } }, "/redgifs/web-urls": { "get": { "tags": [ "redgifs" ], "summary": "Retrieve RedGifs GIF web URLs", "description": "Retrieves web URLs for GIFs based on a search query, with optional filters for count, page, and order.\n\n **Parameters**:\n - **query**: Search query to retrieve GIF URLs (e.g., 'funny'). Required.\n - **count**: Number of results to return (1-100). Defaults to 10.\n - **page**: Page number to retrieve (positive integer). Defaults to 1.\n - **order**: Sorting order: 'TRENDING', 'TOP', 'LATEST', 'OLDEST', 'RECENT', 'BEST', 'TOP28', 'NEW'. Defaults to 'TRENDING'.\n\n **Returns**:\n - A dictionary containing a list of GIF web URLs.\n\n **Raises**:\n - **HTTPException (422)**: If the query is missing.\n - **HTTPException (400)**: If an error occurs during retrieval.", "parameters": [ { "name": "query", "in": "query", "description": "", "required": false, "schema": { "type": "string", "default": "", "description": "" } }, { "name": "count", "in": "query", "description": "", "required": false, "schema": { "type": "string", "default": "10", "description": "" } }, { "name": "page", "in": "query", "description": "", "required": false, "schema": { "type": "string", "default": "1", "description": "" } }, { "name": "order", "in": "query", "description": "", "required": false, "schema": { "type": "string", "default": "trending", "description": "" } } ], "responses": { "200": { "description": "" } }, "security": [], "operationId": "/redgifs/web-urls" } }, "/redgifs/embed-url": { "get": { "tags": [ "redgifs" ], "summary": "Convert RedGifs web URL to embed URL", "description": "Converts a RedGifs web URL to an embed URL for embedding content.\n\n **Parameters**:\n - **web_url**: RedGifs web URL (e.g., 'https://redgifs.com/watch/abcxyz'). Required.\n\n **Returns**:\n - A dictionary containing the embed URL.\n\n **Raises**:\n - **HTTPException (422)**: If the web URL is invalid or missing.\n - **HTTPException (400)**: If an error occurs during conversion.", "parameters": [ { "name": "web_url", "in": "query", "description": "", "required": false, "schema": { "type": "string", "default": "", "description": "" } } ], "responses": { "200": { "description": "" } }, "security": [], "operationId": "/redgifs/embed-url" } }, "/redtube/search": { "get": { "tags": [ "redtube" ], "summary": "Search for videos", "description": "Retrieves a list of videos from the RedTube API based on a search query and optional filters. Supports filtering by category, tags, stars, thumbnail size, sort order, and period. Results are paginated and cached to optimize performance for repeated queries.", "parameters": [ { "name": "search", "in": "query", "description": "", "required": false, "schema": { "type": "string", "default": "", "description": "" } }, { "name": "category", "in": "query", "description": "", "required": false, "schema": { "type": "string", "default": "", "description": "" } }, { "name": "page", "in": "query", "description": "", "required": false, "schema": { "type": "string", "default": "1", "description": "" } }, { "name": "tags", "in": "query", "description": "", "required": false, "schema": { "type": "string", "default": "", "description": "" } }, { "name": "stars", "in": "query", "description": "", "required": false, "schema": { "type": "string", "default": "", "description": "" } }, { "name": "thumbsize", "in": "query", "description": "", "required": false, "schema": { "type": "string", "default": "", "description": "" } }, { "name": "ordering", "in": "query", "description": "", "required": false, "schema": { "type": "string", "default": "", "description": "" } }, { "name": "period", "in": "query", "description": "", "required": false, "schema": { "type": "string", "default": "", "description": "" } } ], "responses": { "200": { "description": "" } }, "security": [], "operationId": "/redtube/search" } }, "/redtube/video": { "get": { "tags": [ "redtube" ], "summary": "Retrieve video details by ID", "description": "Fetches detailed information for a specific video using its ID. Optionally specifies thumbnail size. Results are cached for performance.", "parameters": [ { "name": "video_id", "in": "query", "description": "", "required": false, "schema": { "type": "string", "default": "", "description": "" } }, { "name": "thumbsize", "in": "query", "description": "", "required": false, "schema": { "type": "string", "default": "", "description": "" } } ], "responses": { "200": { "description": "" } }, "security": [], "operationId": "/redtube/video" } }, "/redtube/is-video-active": { "get": { "tags": [ "redtube" ], "summary": "Check if a video is active", "description": "Checks whether a specific video is active (available) on RedTube using its ID. Results are cached for performance.", "parameters": [ { "name": "video_id", "in": "query", "description": "", "required": false, "schema": { "type": "string", "default": "", "description": "" } } ], "responses": { "200": { "description": "" } }, "security": [], "operationId": "/redtube/is-video-active" } }, "/redtube/video-embed-code": { "get": { "tags": [ "redtube" ], "summary": "Retrieve video embed code", "description": "Fetches the embed code for a specific video using its ID. Results are cached for performance.", "parameters": [ { "name": "video_id", "in": "query", "description": "", "required": false, "schema": { "type": "string", "default": "", "description": "" } } ], "responses": { "200": { "description": "" } }, "security": [], "operationId": "/redtube/video-embed-code" } }, "/redtube/deleted-videos": { "get": { "tags": [ "redtube" ], "summary": "Retrieve list of deleted videos", "description": "Fetches a paginated list of videos that have been deleted from RedTube. Results are cached for performance.", "parameters": [ { "name": "page", "in": "query", "description": "", "required": false, "schema": { "type": "string", "default": "1", "description": "" } } ], "responses": { "200": { "description": "" } }, "security": [], "operationId": "/redtube/deleted-videos" } }, "/sexstories/updates": { "get": { "tags": [ "sexstories" ], "summary": "Get Sexstories Updates", "description": "Retrieve recent updates from the sex stories website.\n\nThis endpoint fetches a list of recently added or updated stories, optionally paginated by page number.\n\nParameters:\n- request (Request): The FastAPI request object for logging and error handling.\n- page_number (int, optional): The page number to retrieve (starts at 1). Defaults to None (first page).\n\n\nReturns:\n- Dict: A dictionary containing a list of recent story updates and metadata (e.g., pagination info).\n- None: If no updates are retrieved.\n\nRaises:\n- HTTPException:\n - 500: If an error occurs during scraping or processing (e.g., network issues, parsing errors).\n\nExample:\n```\nGET /sexstories/updates?page_number=2\nResponse:\n{\n \"updates\": [...],\n \"metadata\": {\"page\": 2, \"total_pages\": 10}\n}\n```", "parameters": [ { "name": "page_number", "in": "query", "description": "", "required": false, "schema": { "type": "string", "default": "", "description": "" } } ], "responses": { "200": { "description": "" } }, "security": [], "operationId": "/sexstories/updates" } }, "/sexstories/authors": { "get": { "tags": [ "sexstories" ], "summary": "Get Sexstories Authors", "description": "Retrieve a list of authors, filtered and paginated.\n\nThis endpoint fetches authors based on a specified filter (e.g., by rating, name, number of stories, or date) and page number.\n\nParameters:\n- request (Request): The FastAPI request object for logging and error handling.\n- filter_ (str): The filter to apply. Valid options: 'rate', 'name', 'nbstories', 'date'.\n- page_number (int): The page number to retrieve (starts at 1). Defaults to 1.\n\n\nReturns:\n- Dict: A dictionary containing a list of authors and metadata (e.g., pagination info).\n- None: If no authors are retrieved.\n\nRaises:\n- HTTPException:\n - 400: If an invalid filter is provided.\n - 500: If an error occurs during scraping or processing (e.g., network issues, parsing errors).\n\nExample:\n```\nGET /sexstories/authors?filter_=rate&page_number=1\nResponse:\n{\n \"authors\": [...],\n \"metadata\": {\"filter\": \"rate\", \"page\": 1, \"total_pages\": 5}\n}\n```", "parameters": [ { "name": "filter_", "in": "query", "description": "", "required": false, "schema": { "type": "string", "default": "", "description": "" } }, { "name": "page_number", "in": "query", "description": "", "required": false, "schema": { "type": "string", "default": "1", "description": "" } } ], "responses": { "200": { "description": "" } }, "security": [], "operationId": "/sexstories/authors" } }, "/sexstories/story": { "get": { "tags": [ "sexstories" ], "summary": "Get Sexstory Details", "description": "Retrieve detailed information about a specific story.\n\nThis endpoint fetches details for a story identified by its URL, including title, content, author, and metadata.\n\nParameters:\n- request (Request): The FastAPI request object for logging and error handling.\n- story_url (str): The URL of the story to retrieve details for.\n\n\nReturns:\n- Dict: A dictionary containing story details (e.g., title, content, author, themes).\n- None: If no story details are retrieved.\n\nRaises:\n- HTTPException:\n - 500: If an error occurs during scraping or processing (e.g., invalid URL, network issues).\n\nExample:\n```\nGET /sexstories/story?story_url=https://example.com/story/12345\nResponse:\n{\n \"title\": \"Story Title\",\n \"content\": \"...\",\n \"author\": \"Author Name\",\n \"themes\": [\"2\", \"20\"],\n \"metadata\": {...}\n}\n```", "parameters": [ { "name": "story_url", "in": "query", "description": "", "required": false, "schema": { "type": "string", "default": "", "description": "" } } ], "responses": { "200": { "description": "" } }, "security": [], "operationId": "/sexstories/story" } }, "/sexstories/search": { "get": { "tags": [ "sexstories" ], "summary": "Search Sexstories", "description": "Search for stories based on specified criteria.\n\nThis endpoint allows searching for stories using various parameters such as keywords, category, genre, date range, and sorting options.\n\nParameters:\n- request (Request): The FastAPI request object for logging and error handling.\n- params (SearchRequest): Query parameters for the search, including:\n - page (int): Page number (starts at 1). Default: 1.\n - sort (str): Sort order. Options: relevance, name, rate, view, date. Default: relevance.\n - keywords (str, optional): Search keywords (e.g., 'Anal'). Default: \"\" (all stories).\n - category (str, optional): Category ID (e.g., '2' for Anal). See /sexstories/themes. Default: \"\".\n - genre (str, optional): Genre ID (e.g., '9' for Fantasy). See /sexstories/genres. Default: \"\".\n - date_begin (str, optional): Start date in YYYY-MM-DD format. Default: \"\".\n - date_end (str, optional): End date in YYYY-MM-DD format. Default: \"\".\n - type (str): Content type to search. Default: \"stories\".\n\n\nReturns:\n- Dict: A dictionary with:\n - results: List of matching stories or content.\n - metadata: Search parameters and metadata (e.g., page, total results, URL).\n\nRaises:\n- HTTPException:\n - 400: If invalid category, genre, or other parameters are provided.\n - 500: If an error occurs during scraping or processing (e.g., network issues).\n\nExample:\n```\nGET /sexstories/search?page=1&sort=relevance&keywords=Anal&category=2&genre=9&date_begin=2024-04-17&date_end=2025-04-18\nResponse:\n{\n \"results\": [\n {\"title\": \"Story 1\", \"url\": \"...\", \"themes\": [\"2\"], \"genres\": [\"9\"], ...},\n ...\n ],\n \"metadata\": {\n \"page\": 1,\n \"total_results\": 100,\n \"search_url\": \"...\",\n \"parameters\": {...}\n }\n}\n```", "parameters": [ { "name": "page", "in": "query", "description": "", "required": false, "schema": { "type": "string", "default": "1", "description": "" } }, { "name": "sort", "in": "query", "description": "", "required": false, "schema": { "type": "string", "default": "relevance", "description": "" } }, { "name": "keywords", "in": "query", "description": "", "required": false, "schema": { "type": "string", "default": "", "description": "" } }, { "name": "category", "in": "query", "description": "", "required": false, "schema": { "type": "string", "default": "", "description": "" } }, { "name": "genre", "in": "query", "description": "", "required": false, "schema": { "type": "string", "default": "", "description": "" } }, { "name": "date_begin", "in": "query", "description": "", "required": false, "schema": { "type": "string", "default": "", "description": "" } }, { "name": "date_end", "in": "query", "description": "", "required": false, "schema": { "type": "string", "default": "", "description": "" } }, { "name": "type", "in": "query", "description": "", "required": false, "schema": { "type": "string", "default": "stories", "description": "" } } ], "responses": { "200": { "description": "" } }, "security": [], "operationId": "/sexstories/search" } }, "/motherless/search": { "get": { "tags": [ "motherless" ], "summary": "Get Motherless Search", "description": "Retrieve search results from Motherless based on the provided query and filters.\n\nArgs:\n search_query: The search term to query Motherless.\n sort: Sorting option for results (e.g., relevance, views, rating, date, duration).\n durf: Duration filter for videos (e.g., 1-3min, 3-10min, 10-20min, 20min).\n quality: Quality filter for videos (e.g., all, hd, 4k).\n datef: Date filter for videos (e.g., today, week, month, year, alltime).\n\nReturns:\n List of dictionaries containing video details (title, thumbnail, view_count, duration, rating, uploader_username).\n\nRaises:\n HTTPException: If the search query is empty or an error occurs during scraping.", "parameters": [ { "name": "search_query", "in": "query", "description": "", "required": false, "schema": { "type": "string", "default": "", "description": "" } }, { "name": "sort", "in": "query", "description": "", "required": false, "schema": { "type": "string", "default": "", "description": "" } }, { "name": "durf", "in": "query", "description": "", "required": false, "schema": { "type": "string", "default": "", "description": "" } }, { "name": "quality", "in": "query", "description": "", "required": false, "schema": { "type": "string", "default": "", "description": "" } }, { "name": "datef", "in": "query", "description": "", "required": false, "schema": { "type": "string", "default": "", "description": "" } } ], "responses": { "200": { "description": "" } }, "security": [], "operationId": "/motherless/search" } }, "/tnaflix/feed": { "get": { "tags": [ "tnaflix" ], "summary": "Get Tnaflix Feed", "description": "Retrieve a feed of videos from TNAFlix.\n\nThis endpoint scrapes video data from TNAFlix based on the specified page number, feed type, and duration filter.\nThe response includes details such as title, quality, duration, thumbnail, thumbnail trailer, URL, user profile URL,\nusername, views, and likes for each video.\n\nArgs:\n request (Request): The incoming HTTP request.\n page (int, optional): The page number to scrape (0 for the first page). Defaults to 0.\n feed_type (str, optional): The type of feed to scrape ('new', 'featured', 'toprated'). Defaults to 'new'.\n duration (str, optional): Duration filter for videos ('short', 'medium', 'long', 'full'). Defaults to no filter.\n tf_api (TnaflixApi): The TNAFlix API dependency for scraping.\n\nReturns:\n List[Dict[str, str]]: A list of dictionaries containing video details with the following keys:\n - title: Video title.\n - quality: Video quality (e.g., '720p', '4p').\n - duration: Video duration (e.g., '17:14').\n - thumbnail: URL of the video thumbnail.\n - thumbnail_trailer: URL of the trailer thumbnail.\n - url: URL of the video page.\n - user_profile_url: URL of the uploader's profile.\n - username: Username of the uploader.\n - views: Number of views.\n - likes: Number of likes (or 'N/A' if not available).\n\nRaises:\n HTTPException: If an error occurs during scraping, returns a 400 status code with the error message.", "parameters": [ { "name": "page", "in": "query", "description": "", "required": false, "schema": { "type": "string", "default": "", "description": "" } }, { "name": "feed_type", "in": "query", "description": "", "required": false, "schema": { "type": "string", "default": "new", "description": "" } }, { "name": "duration", "in": "query", "description": "", "required": false, "schema": { "type": "string", "default": "", "description": "" } } ], "responses": { "200": { "description": "" } }, "security": [], "operationId": "/tnaflix/feed" } }, "/tnaflix/search": { "get": { "tags": [ "tnaflix" ], "summary": "Get Tnaflix Search", "description": "Retrieve search results from TNAFlix.\n\nThis endpoint scrapes video data from TNAFlix based on the provided search query, page number,\nupload time filter, and duration filter. The response includes details such as title, quality,\nduration, thumbnail, thumbnail trailer, URL, user profile URL, username, views, and likes for each video.\n\nArgs:\n request (Request): The incoming HTTP request.\n query (str): The search query for videos (e.g., 'ass'). Required.\n page (int, optional): The page number to scrape (1 for the first page). Defaults to 1.\n uploaded_when (str, optional): Filter for when videos were uploaded ('day', 'week', 'month', 'year'). Defaults to no filter.\n duration (str, optional): Duration filter for videos ('short', 'medium', 'long', 'full'). Defaults to no filter.\n tf_api (TnaflixApi): The TNAFlix API dependency for scraping.\n\nReturns:\n List[Dict[str, str]]: A list of dictionaries containing video details with the following keys:\n - title: Video title.\n - quality: Video quality (e.g., '720p', '4p').\n - duration: Video duration (e.g., '17:14').\n - thumbnail: URL of the video thumbnail.\n - thumbnail_trailer: URL of the trailer thumbnail.\n - url: URL of the video page.\n - user_profile_url: URL of the uploader's profile.\n - username: Username of the uploader.\n - views: Number of views.\n - likes: Number of likes (or 'N/A' if not available).\n\nRaises:\n HTTPException: If an error occurs during scraping, returns a 400 status code with the error message.", "parameters": [ { "name": "query", "in": "query", "description": "", "required": false, "schema": { "type": "string", "default": "", "description": "" } }, { "name": "page", "in": "query", "description": "", "required": false, "schema": { "type": "string", "default": "1", "description": "" } }, { "name": "uploaded_when", "in": "query", "description": "", "required": false, "schema": { "type": "string", "default": "", "description": "" } }, { "name": "duration", "in": "query", "description": "", "required": false, "schema": { "type": "string", "default": "", "description": "" } } ], "responses": { "200": { "description": "" } }, "security": [], "operationId": "/tnaflix/search" } }, "/tnaflix/video-info": { "get": { "tags": [ "tnaflix" ], "summary": "Scrape detailed video information from a Tnaflix video URL", "description": "Extracts detailed metadata from a Tnaflix video page, including title, thumbnail, video URLs with quality, likes, dislikes, badges, views, upload date, description, tags, and duration. Requires a valid API key.", "parameters": [ { "name": "video_url", "in": "query", "description": "", "required": false, "schema": { "type": "string", "default": "", "description": "" } } ], "responses": { "200": { "description": "" } }, "security": [], "operationId": "/tnaflix/video-info" } }, "/xhamster/video-information": { "get": { "tags": [ "xhamster", "Video Information" ], "summary": "Retrieve detailed information about a specific xHamster video", "description": "Fetches comprehensive metadata for a given xHamster video URL. The endpoint scrapes details such as the video title, views, rating, tags, author information (name, avatar, subscribers, URL), likes, dislikes, related videos, comments, video URL, and embed URL. Results are cached to improve performance for repeated requests.\n \n **Note**: The provided URL must be a valid xHamster video URL. Invalid URLs will result in a 400 error.", "parameters": [ { "name": "video_url", "in": "query", "description": "", "required": false, "schema": { "type": "string", "default": "", "description": "" } } ], "responses": { "200": { "description": "" } }, "security": [], "operationId": "/xhamster/video-information" } }, "/xhamster/videos": { "get": { "tags": [ "xhamster", "Videos List" ], "summary": "Retrieve a list of videos from xHamster with filters and pagination", "description": "Fetches a list of videos from xHamster based on filters like category, quality, sort, etc.\n \n **Filtering Rules**:\n - Default: Trending videos (main page).\n - Category: 'hd', '4k', 'vr' (path: /hd, /4k, /vr).\n - Full length: Adds '/full-length' to URL (e.g., /hd/full-length).\n - Sort: 'newest' (/newest), 'best' (/best/), 'most-viewed' (/most-viewed/), 'most-commented' (/most-commented/).\n - Period: 'weekly' (default), 'monthly', 'daily', 'year-2025'.\n - Quality: Query param ?quality=1080p etc. (for hd/vr).\n - FPS: ?fps=30 etc.\n - Duration: ?min-duration=10&max-duration=30.\n - VR-specific: ?angle=180&dimension=3d.\n - Pagination: / if page >1.\n \n Results are cached for repeated queries.", "parameters": [ { "name": "page", "in": "query", "description": "", "required": false, "schema": { "type": "string", "default": "1", "description": "" } }, { "name": "category", "in": "query", "description": "", "required": false, "schema": { "type": "string", "default": "", "description": "" } }, { "name": "quality", "in": "query", "description": "", "required": false, "schema": { "type": "string", "default": "", "description": "" } }, { "name": "fps", "in": "query", "description": "", "required": false, "schema": { "type": "string", "default": "", "description": "" } }, { "name": "sort", "in": "query", "description": "", "required": false, "schema": { "type": "string", "default": "", "description": "" } }, { "name": "period", "in": "query", "description": "", "required": false, "schema": { "type": "string", "default": "weekly", "description": "" } }, { "name": "full_length", "in": "query", "description": "", "required": false, "schema": { "type": "string", "default": "", "description": "" } }, { "name": "min_duration", "in": "query", "description": "", "required": false, "schema": { "type": "string", "default": "", "description": "" } }, { "name": "max_duration", "in": "query", "description": "", "required": false, "schema": { "type": "string", "default": "", "description": "" } }, { "name": "angle", "in": "query", "description": "", "required": false, "schema": { "type": "string", "default": "", "description": "" } }, { "name": "dimension", "in": "query", "description": "", "required": false, "schema": { "type": "string", "default": "", "description": "" } } ], "responses": { "200": { "description": "" } }, "security": [], "operationId": "/xhamster/videos" } }, "/xhamster/search": { "get": { "tags": [ "xhamster", "Search Videos" ], "summary": "Search xHamster videos with advanced filtering and pagination", "description": "Searches xHamster for videos based on a query with advanced filtering options.\n\n **Filtering Rules**:\n - **Query**: Required search term (e.g., 'boobs'). Spaces are replaced with '+' in the URL.\n - **Orientations**: Filter by orientation ('straight', 'gay', 'shemale'). Default: ['straight']. Multiple values are comma-separated (e.g., ?orientations=straight,gay).\n - **Categories**: Filter by categories (e.g., 'en', 'american', 'big-ass'). Spaces in category names are replaced with dashes (e.g., 'big-ass'). Multiple categories are comma-separated (e.g., ?cats=en,american,big-ass).\n - Available categories: 'en', 'american', 'big-tits', 'ass', 'big-ass', 'amateur', 'teen', 'homemade', 'creampie', 'big-cock', 'african', 'blowjob', 'milf', 'bbc', 'black', 'compilation', 'pov', 'threesome', 'pussy', 'latina'.\n - **Quality**: Filter by video quality ('720p', '1080p', '2160p', '1440p', '1920p'). Added as ?quality=.\n - **FPS**: Filter by frames per second (30, 60). Added as ?fps=.\n - **Sort**: Sort results by 'relevance' (default), 'newest', 'views', 'best', 'longest'. Added as ?sort=.\n - **Date**: Filter by upload date ('latest', 'weekly', 'monthly', 'yearly'). Added as ?date=.\n - **Full Length**: If True, filters for full-length videos (?length=full).\n - **Duration**: Filter by minimum (?min-duration=) and maximum (?max-duration=) duration in minutes.\n - **VR Filters**: \n - **vr_only**: If True, filters for VR videos only (?format=vr).\n - **angle**: VR angle (180, 360). Added as ?angle=.\n - **dimension**: VR dimension ('2d', '3d'). Added as ?dimension=.\n - **Pagination**: Page number added as ?page= if >1.\n - **URL Example**: https://xhamster.com/search/boobs?orientations=straight,gay&cats=big-tits,amateur&quality=1080p&sort=newest&date=weekly&length=full&min-duration=2&max-duration=30\n\n Results are cached for repeated queries.", "parameters": [ { "name": "query", "in": "query", "description": "", "required": false, "schema": { "type": "string", "default": "", "description": "" } }, { "name": "page", "in": "query", "description": "", "required": false, "schema": { "type": "string", "default": "1", "description": "" } }, { "name": "orientations", "in": "query", "description": "", "required": false, "schema": { "type": "string", "default": "straight", "description": "" } }, { "name": "categories", "in": "query", "description": "", "required": false, "schema": { "type": "string", "default": "", "description": "" } }, { "name": "quality", "in": "query", "description": "", "required": false, "schema": { "type": "string", "default": "", "description": "" } }, { "name": "fps", "in": "query", "description": "", "required": false, "schema": { "type": "string", "default": "", "description": "" } }, { "name": "sort", "in": "query", "description": "", "required": false, "schema": { "type": "string", "default": "relevance", "description": "" } }, { "name": "date", "in": "query", "description": "", "required": false, "schema": { "type": "string", "default": "", "description": "" } }, { "name": "full_length", "in": "query", "description": "", "required": false, "schema": { "type": "string", "default": "", "description": "" } }, { "name": "min_duration", "in": "query", "description": "", "required": false, "schema": { "type": "string", "default": "", "description": "" } }, { "name": "max_duration", "in": "query", "description": "", "required": false, "schema": { "type": "string", "default": "", "description": "" } }, { "name": "angle", "in": "query", "description": "", "required": false, "schema": { "type": "string", "default": "", "description": "" } }, { "name": "dimension", "in": "query", "description": "", "required": false, "schema": { "type": "string", "default": "", "description": "" } }, { "name": "vr_only", "in": "query", "description": "", "required": false, "schema": { "type": "string", "default": "", "description": "" } } ], "responses": { "200": { "description": "" } }, "security": [], "operationId": "/xhamster/search" } }, "/xhamster/pornstar-information": { "get": { "tags": [ "xhamster", "Pornstar Information" ], "summary": "Retrieve information about a specific xHamster pornstar with pagination", "description": "Fetches comprehensive metadata for a given xHamster pornstar, including personal details, moments, recommended videos, trending videos, and pagination information.\n\n **Parameters**:\n - **pornstar_name**: Required, e.g., 'alyx-star'. Spaces are replaced with dashes in the URL.\n - **page**: Page number for pagination (default: 1). Added as ?page= if >1.\n - **URL Example**: https://xhamster.com/pornstars/alyx-star?page=2\n\n Results are cached for repeated queries.", "parameters": [ { "name": "pornstar_name", "in": "query", "description": "", "required": false, "schema": { "type": "string", "default": "", "description": "" } }, { "name": "page", "in": "query", "description": "", "required": false, "schema": { "type": "string", "default": "1", "description": "" } } ], "responses": { "200": { "description": "" } }, "security": [], "operationId": "/xhamster/pornstar-information" } }, "/xnxx/todays-selection": { "get": { "tags": [ "xnxx" ], "summary": "Fetch Todays Selection Route", "description": "Fetch today's selection for a given date (YYYY-MM-DD).\n\nParams:\n date: Date in YYYY-MM-DD format (required).\n page_number: Page number for paginated results (optional).", "parameters": [ { "name": "date", "in": "query", "description": "", "required": false, "schema": { "type": "string", "default": "", "description": "" } }, { "name": "page_number", "in": "query", "description": "", "required": false, "schema": { "type": "string", "default": "", "description": "" } } ], "responses": { "200": { "description": "" } }, "security": [], "operationId": "/xnxx/todays-selection" } }, "/xnxx/best-videos": { "get": { "tags": [ "xnxx" ], "summary": "Fetch Best Videos Route", "description": "Fetch the best videos for a given date (YYYY-MM format).\n\nParams:\n date: Date in YYYY-MM format (required).\n page_number: Page number for paginated results (optional).", "parameters": [ { "name": "date", "in": "query", "description": "", "required": false, "schema": { "type": "string", "default": "", "description": "" } }, { "name": "page_number", "in": "query", "description": "", "required": false, "schema": { "type": "string", "default": "", "description": "" } } ], "responses": { "200": { "description": "" } }, "security": [], "operationId": "/xnxx/best-videos" } }, "/xnxx/hits": { "get": { "tags": [ "xnxx" ], "summary": "Fetch Hits Route", "description": "Fetch hits for a given period (day, week, month, or all). \n\nParams:\n period: Time period (day, week, month). Leave Blank for all\n page_number: Page number for paginated results (optional).", "parameters": [ { "name": "period", "in": "query", "description": "", "required": false, "schema": { "type": "string", "default": "", "description": "" } }, { "name": "page_number", "in": "query", "description": "", "required": false, "schema": { "type": "string", "default": "", "description": "" } } ], "responses": { "200": { "description": "" } }, "security": [], "operationId": "/xnxx/hits" } }, "/xnxx/search": { "get": { "tags": [ "xnxx" ], "summary": "Search Route", "description": "Search xnxx for galleries based on a query and optional parameters.\n\nParams:\n query: A string representing the search query (required).\n mode: Search mode (default, hits, random).\n period: Time period (ever, year, month).\n length: Video length filter (all, 0-10min, 10min+, 10-20min, 20min+).\n quality: Video quality filter (all, hd-only, fullhd).\n page_number: Page number for paginated results (optional).", "parameters": [ { "name": "query", "in": "query", "description": "", "required": false, "schema": { "type": "string", "default": "", "description": "" } }, { "name": "mode", "in": "query", "description": "", "required": false, "schema": { "type": "string", "default": "default", "description": "" } }, { "name": "period", "in": "query", "description": "", "required": false, "schema": { "type": "string", "default": "ever", "description": "" } }, { "name": "length", "in": "query", "description": "", "required": false, "schema": { "type": "string", "default": "all", "description": "" } }, { "name": "quality", "in": "query", "description": "", "required": false, "schema": { "type": "string", "default": "all", "description": "" } }, { "name": "page_number", "in": "query", "description": "", "required": false, "schema": { "type": "string", "default": "", "description": "" } } ], "responses": { "200": { "description": "" } }, "security": [], "operationId": "/xnxx/search" } }, "/xnxx/tags": { "get": { "tags": [ "xnxx" ], "summary": "Fetch Tags Route", "description": "Fetch tags based on the provided filter.\n\nParams:\n filter_by: The letter or word 'alphanumeric' value to filter tags by. Default is 'all'", "parameters": [ { "name": "filter_by", "in": "query", "description": "", "required": false, "schema": { "type": "string", "default": "all", "description": "" } } ], "responses": { "200": { "description": "" } }, "security": [], "operationId": "/xnxx/tags" } }, "/xnxx/video-information": { "get": { "tags": [ "xnxx", "Video Information" ], "summary": "Retrieve detailed information about a specific XNXX video", "description": "Fetches comprehensive metadata for a given XNXX video URL. The endpoint scrapes details such as the video title, duration, quality, view count, rating, likes, dislikes, tags, embed URL, comments, description, and video URLs (high and low quality). Results are cached to improve performance for repeated requests.\n \n **Note**: The provided URL must be a valid XNXX video URL. Invalid URLs will result in a 400 error.", "parameters": [ { "name": "video_url", "in": "query", "description": "", "required": false, "schema": { "type": "string", "default": "", "description": "" } } ], "responses": { "200": { "description": "" } }, "security": [], "operationId": "/xnxx/video-information" } }, "/xvideos/feed": { "get": { "tags": [ "xvideos" ], "summary": "Retrieve the Xvideos feed", "description": "Fetches the latest video feed from Xvideos, optionally filtered by sexual orientation and paginated by page number.\n The endpoint returns a list of video metadata, including titles, thumbnails, durations, and links.\n\n **Parameters**:\n - **page**: Page number for pagination (1 to 100,000, limited by total_pages in response). Defaults to 0.\n - **sexual_orientation**: Filter by sexual orientation (e.g., 'shemale', 'gay'). Leave empty for straight content.\n\n **Returns**:\n - A list of video metadata objects containing details such as title, duration, thumbnail URL, and video URL.\n\n **Raises**:\n - **HTTPException (400)**: If invalid parameters are provided or fails.", "parameters": [ { "name": "page", "in": "query", "description": "", "required": false, "schema": { "type": "string", "default": "", "description": "" } }, { "name": "sexual_orientation", "in": "query", "description": "", "required": false, "schema": { "type": "string", "default": "", "description": "" } } ], "responses": { "200": { "description": "" } }, "security": [], "operationId": "/xvideos/feed" } }, "/xvideos/search": { "get": { "tags": [ "xvideos" ], "summary": "Search for videos on Xvideos", "description": "Searches Xvideos for videos based on a query string with optional filters for sorting, duration, quality, and date.\n Results are cached to improve performance for repeated requests. The endpoint returns a list of video metadata.\n\n **Parameters**:\n - **search_query**: The search term (e.g., 'Mia Khalifa'). Required.\n - **sort**: Sorting option. Valid values: 'relevance', 'uploaddate' (Newest), 'rating', 'length', 'views', 'random'. Defaults to None.\n - **durf**: Duration filter. Valid values: 'allduration', '1-3min' (Short videos), '3-10min' (Medium videos), '10-20min' (Long videos), '20min+' (Long videos). Defaults to None.\n - **quality**: Quality filter (e.g., 'all', 'hd', '1080P'). Defaults to None.\n - **datef**: Date filter (e.g., 'today', 'week', 'month'). Defaults to None.\n - **p**: Page filter (e.g., '1', '2', '20', '132'). Defaults to None.\n\n **Returns**:\n - A list of video metadata objects containing details such as title, duration, thumbnail URL, and video URL.\n\n **Raises**:\n - **HTTPException (422)**: If the search query is not specified.\n - **HTTPException (400)**: If invalid parameters are provided.", "parameters": [ { "name": "search_query", "in": "query", "description": "", "required": false, "schema": { "type": "string", "default": "", "description": "" } }, { "name": "sort", "in": "query", "description": "", "required": false, "schema": { "type": "string", "default": "", "description": "" } }, { "name": "durf", "in": "query", "description": "", "required": false, "schema": { "type": "string", "default": "", "description": "" } }, { "name": "quality", "in": "query", "description": "", "required": false, "schema": { "type": "string", "default": "", "description": "" } }, { "name": "datef", "in": "query", "description": "", "required": false, "schema": { "type": "string", "default": "", "description": "" } }, { "name": "p", "in": "query", "description": "", "required": false, "schema": { "type": "string", "default": "", "description": "" } } ], "responses": { "200": { "description": "" } }, "security": [], "operationId": "/xvideos/search" } }, "/xvideos/pornstar": { "get": { "tags": [ "xvideos" ], "summary": "Retrieve pornstar information from Xvideos", "description": "Fetches detailed information about a pornstar from Xvideos using the provided model name. \n The endpoint returns metadata such as total video views, profile hits, last activity, and tags.\n\n **Parameters**:\n - **model_name**: The name of the pornstar (e.g., 'Abella Danger'). Required, must not be empty or whitespace-only.\n\n **Returns**:\n - A dictionary containing the pornstar's metadata, such as total video views, profile hits, and tags.\n\n **Raises**:\n - **HTTPException (400)**: If the model name is empty, whitespace-only.", "parameters": [ { "name": "model_name", "in": "query", "description": "", "required": false, "schema": { "type": "string", "default": "", "description": "" } } ], "responses": { "200": { "description": "" } }, "security": [], "operationId": "/xvideos/pornstar" } }, "/xvideos/categories": { "get": { "tags": [ "xvideos" ], "summary": "Retrieve Xvideos categories", "description": "Fetches a list of video categories from Xvideos, optionally filtered by sexual orientation. \n The endpoint returns a list of category metadata, including category names and links.\n\n **Parameters**:\n - **sexual_orientation**: Filter by sexual orientation (e.g., 'shemale', 'gay'). Leave empty for straight content.\n\n **Returns**:\n - A list of category metadata objects containing details such as category name and URL.\n\n **Raises**:\n - **HTTPException (400)**", "parameters": [ { "name": "sexual_orientation", "in": "query", "description": "", "required": false, "schema": { "type": "string", "default": "", "description": "" } } ], "responses": { "200": { "description": "" } }, "security": [], "operationId": "/xvideos/categories" } }, "/xvideos/pornstars-index": { "get": { "tags": [ "xvideos" ], "summary": "Retrieve a paginated index of pornstars from Xvideos", "description": "Fetches a paginated list of pornstars from Xvideos. The endpoint returns a list of pornstar metadata, \n including names and profile URLs.\n\n **Parameters**:\n - **page**: Page number for pagination (1 to 100,000, limited by total_pages in response). Defaults to 0.\n\n **Returns**:\n - A list of pornstar metadata objects containing details such as name and profile URL.\n\n **Raises**:\n - **HTTPException (400)**", "parameters": [ { "name": "page", "in": "query", "description": "", "required": false, "schema": { "type": "string", "default": "", "description": "" } } ], "responses": { "200": { "description": "" } }, "security": [], "operationId": "/xvideos/pornstars-index" } }, "/xvideos/video-information": { "get": { "tags": [ "xvideos", "Video Information" ], "summary": "Retrieve detailed information about a specific Xvideos video", "description": "Fetches comprehensive metadata for a given Xvideos video URL. The endpoint scrapes details such as the video title, duration, quality, uploader information, model details, tags, like/dislike counts, video URLs (HD and SD), embed URL, and related videos. Results are cached to improve performance for repeated requests.\n \n **Note**: The provided URL must be a valid Xvideos video URL. Invalid URLs will result in a 400 error.", "parameters": [ { "name": "video_url", "in": "query", "description": "", "required": false, "schema": { "type": "string", "default": "", "description": "" } } ], "responses": { "200": { "description": "" } }, "security": [], "operationId": "/xvideos/video-information" } }, "/auntmia/search-by-category": { "get": { "tags": [ "auntmia" ], "summary": "Get Category Search", "description": "", "parameters": [ { "name": "category", "in": "query", "description": "", "required": false, "schema": { "type": "string", "default": "", "description": "" } } ], "responses": { "200": { "description": "", "content": { "text/plain": { "example": { "value": {} } } } } }, "security": [], "operationId": "/auntmia/search-by-category" } }, "/auntmia/search-pornstars": { "get": { "tags": [ "auntmia" ], "summary": "Search Pornstars Route", "description": "Search for pornstars by race, nationality, and body type filters.\n\nArgs:\n request (Request): The FastAPI request object.\n race (Union[str, None], optional): Race filter (e.g., 'latina', 'white', 'black').\n nationality (Union[str, None], optional): Nationality filter (e.g., 'argentine', 'american').\n body (Union[str, None], optional): Body type filter (e.g., 'curvy', 'chubby', 'slim').\n am_api (AuntMiaApi): The API client for scraping auntmia.com.\n\nReturns:\n List[Dict]: A list of dictionaries containing pornstar information (thumbnail_url, gallery_url, title, category).\n\nRaises:\n HTTPException: If an error occurs during scraping.", "parameters": [ { "name": "race", "in": "query", "description": "", "required": false, "schema": { "type": "string", "default": "", "description": "" } }, { "name": "nationality", "in": "query", "description": "", "required": false, "schema": { "type": "string", "default": "", "description": "" } }, { "name": "body", "in": "query", "description": "", "required": false, "schema": { "type": "string", "default": "", "description": "" } } ], "responses": { "200": { "description": "" }, "400": { "description": "", "content": { "application/json": { "schema": { "type": "object", "properties": { "detail": { "type": "string", "example": "404: No pornstars found for the specified filters." } } } } }, "headers": { "content-length": { "description": "", "schema": { "type": "string", "example": "63" } }, "content-type": { "description": "", "schema": { "type": "string", "example": "application/json" } } } } }, "security": [], "operationId": "/auntmia/search-pornstars" } }, "/barelist/video-information": { "get": { "tags": [ "barelist" ], "summary": "Retrieve detailed information about a Barelist video", "description": "Fetches metadata for a video from Barelist using either a video ID or URL. Includes details such as the model's name, profile picture, Barelist rank, career status, country, height, hair color, bust size, video title, and raw MP4 video URL.", "parameters": [ { "name": "video_id", "in": "query", "description": "", "required": false, "schema": { "type": "string", "default": "", "description": "" } } ], "responses": { "200": { "description": "" }, "400": { "description": "", "content": { "application/json": { "schema": { "type": "object", "properties": { "detail": { "type": "string", "example": "No video ID or URL provided" } } } } }, "headers": { "content-length": { "description": "", "schema": { "type": "string", "example": "40" } }, "content-type": { "description": "", "schema": { "type": "string", "example": "application/json" } } } } }, "security": [], "operationId": "/barelist/video-information" } }, "/auntmia/feed": { "get": { "tags": [ "auntmia" ], "summary": "Get Auntmia Feed", "description": "", "parameters": [], "responses": { "200": { "description": "", "content": { "application/json": { "schema": { "type": "array", "items": { "type": "object", "properties": { "thumbnail_url": { "type": "string", "example": "https://t.auntmia.com/nthumbs/2021-04-14/3887651/3887651_02.jpg" }, "category": { "type": "string", "example": "Sexy" }, "link_url": { "type": "string", "example": "https://www.auntmia.com/pics/sexy/" }, "title": { "type": "string", "example": "Sexy" } } } } } }, "headers": { "content-type": { "description": "", "schema": { "type": "string", "example": "application/json" } } } } }, "security": [], "operationId": "/auntmia/feed" } } }, "components": {} }