### GET /

Source: https://api.adultdatalink.com/openapi.json

API endpoint for GET /

```markdown
### Responses

#### 200 - Successful Response


### Example Usage

```bash
curl -X GET "https://api.example.com/"
```

```

--------------------------------

### GET /pimpandhost/category-media

Source: https://api.adultdatalink.com/openapi.json

API endpoint for GET /pimpandhost/category-media

```markdown
### Parameters

- **category** (string, query, optional): category media (eg. Amateur)
- **page** (integer, query, optional): Number of results to return (max 100)
- **per_page** (integer, query, optional): Page number to return (positive integer)

### Responses

#### 200 - Successful Response


#### 404 - Not found

Not found

#### 422 - Validation Error

**HTTPValidationError**
- **detail** (array (ValidationError))
  Array items:
    - **loc** (array (union)) (required)
    - **msg** (string) (required)
    - **type** (string) (required)

### Example Usage

```bash
curl -X GET "https://api.example.com/pimpandhost/category-media?category=string&page=10&per_page=1"
```

```

--------------------------------

### GET /pimpandhost/pornstar-media

Source: https://api.adultdatalink.com/openapi.json

API endpoint for GET /pimpandhost/pornstar-media

```markdown
### Parameters

- **pornstar** (string, query, optional): Pornstar name (eg. Mia Khalifa)
- **page** (integer, query, optional): Number of results to return (max 100)
- **per_page** (integer, query, optional): Page number to return (positive integer)

### Responses

#### 200 - Successful Response


#### 404 - Not found

Not found

#### 422 - Validation Error

**HTTPValidationError**
- **detail** (array (ValidationError))
  Array items:
    - **loc** (array (union)) (required)
    - **msg** (string) (required)
    - **type** (string) (required)

### Example Usage

```bash
curl -X GET "https://api.example.com/pimpandhost/pornstar-media?pornstar=string&page=10&per_page=1"
```

```

--------------------------------

### GET /xhamster/pornstar-information

Source: https://api.adultdatalink.com/openapi.json

Fetches comprehensive metadata for a given xHamster pornstar, including personal details, moments, recommended videos, trending videos, and pagination information.

    **Parameters**:
    - **pornstar_name**: Required, e.g., 'alyx-star'. Spaces are replaced with dashes in the URL.
    - **page**: Page number for pagination (default: 1). Added as ?page=<value> if >1.
    - **URL Example**: https://xhamster.com/pornstars/alyx-star?page=2

    Results are cached for repeated queries.

```markdown
### Parameters

- **pornstar_name** (string, query, required): Pornstar name (e.g., 'alyx-star')
- **page** (integer, query, optional): Page number for pagination

### Responses

#### 200 - Successful response with pornstar information


#### 400 - Invalid pornstar name or scraping error

#### 404 - Not found

Not found

#### 422 - Validation Error

**HTTPValidationError**
- **detail** (array (ValidationError))
  Array items:
    - **loc** (array (union)) (required)
    - **msg** (string) (required)
    - **type** (string) (required)

#### 500 - Internal server error

### Example Usage

```bash
curl -X GET "https://api.example.com/xhamster/pornstar-information?pornstar_name=string&page=1"
```

```

--------------------------------

### GET /letsjerktv/pornstar-videos

Source: https://api.adultdatalink.com/openapi.json

API endpoint for GET /letsjerktv/pornstar-videos

```markdown
### Parameters

- **pornstar_url** (string, query, optional): the url of the pornstar (eg: https://letsjerk.tv/performer/abella-danger/)
- **page** (integer, query, optional): Results page number. Valid range is (1, 100000) but no more than total_pages received in response.

### Responses

#### 200 - Successful Response


#### 404 - Not found

Not found

#### 422 - Validation Error

**HTTPValidationError**
- **detail** (array (ValidationError))
  Array items:
    - **loc** (array (union)) (required)
    - **msg** (string) (required)
    - **type** (string) (required)

### Example Usage

```bash
curl -X GET "https://api.example.com/letsjerktv/pornstar-videos?pornstar_url=string&page=1"
```

```

--------------------------------

### GET /letsjerktv/category-videos

Source: https://api.adultdatalink.com/openapi.json

API endpoint for GET /letsjerktv/category-videos

```markdown
### Parameters

- **category** (string, query, optional): Valid category (eg: 1080p)
- **page** (integer, query, optional): Results page number. Valid range is (1, 100000) but no more than total_pages received in response.

### Responses

#### 200 - Successful Response


#### 404 - Not found

Not found

#### 422 - Validation Error

**HTTPValidationError**
- **detail** (array (ValidationError))
  Array items:
    - **loc** (array (union)) (required)
    - **msg** (string) (required)
    - **type** (string) (required)

### Example Usage

```bash
curl -X GET "https://api.example.com/letsjerktv/category-videos?category=string&page=1"
```

```

--------------------------------

### GET /pornpics/pornstars

Source: https://api.adultdatalink.com/openapi.json

Search pornstars on **PornPics** using powerful, combinable filters.

        ---

        ### Available Filters (all optional)

        - **`orientation`**  
          Values: `straight`, `gay`, `shemale`  
          _Example_: `gay`

        - **`gender`**  
          Values: `female`, `male`  
          _Example_: `female`

        - **`body`**  
          Values: `bbw`, `petite`, `skinny`, `tall`, `short`  
          _Example_: `bbw`

        - **`hair`**  
          Values: `blonde`, `brunette`, `redhead`  
          _Example_: `blonde`

        - **`tits`**  
          Values: `big-tits`, `tiny-tits`, `fake-tits`, `natural-tits`  
          _Example_: `big-tits`

        - **`ethnicity`**  
          Values: `white`, `black`, `latina`, `asian`, `indian`  
          _Example_: `asian`

        - **`nationality`**  
          2-letter country code (ISO 3166-1 alpha-2)  
          _Examples_: `us`, `gb`, `jp`, `de`, `br`, `ru`  
          _Example_: `us`

        - **`age`**  
          Values: `teen`, `mature`, `milf`, `granny`  
          _Example_: `teen`

        - **`sort`** *(default: `popular`)*  
          Values: `popular`, `date`, `trending`, `sum` (most galleries), `name`  
          _Example_: `trending`

        - **`page`** *(≥1)*  
          Page number for pagination  
          _Example_: `2`

        ---

        ### Pagination
        Use `page=1`, `page=2`, etc., to navigate results.  
        Combine with any filters for precise control.

        ---

        ### Response
        Returns a list of pornstars with:
        - **Name**
        - **Profile URL**
        - **Gallery count**
        - **Country flag**
        - **Preview image**

        > **Tip**: Combine filters like `?body=bbw&hair=blonde&sort=trending&page=1` for targeted results.

        ---

        **Example Request**:
        GET /pornpics/pornstars?body=bbw&hair=blonde&sort=trending

```markdown
### Parameters

- **orientation** (string, query, optional): Orientation filter
- **gender** (string, query, optional): Gender filter
- **body** (string, query, optional): Body type
- **hair** (string, query, optional): Hair color
- **tits** (string, query, optional): Breast size/type
- **ethnicity** (string, query, optional): Ethnicity
- **nationality** (string, query, optional): 2-letter country code (ISO 3166-1 alpha-2)
- **age** (string, query, optional): Age category
- **sort** (string, query, optional): Sort order
- **page** (integer, query, optional): Page number (starts at 1)

### Responses

#### 200 - List of pornstars matching filters


#### 400 - Invalid filter value

Invalid filter value

#### 404 - No pornstars found

No pornstars found

#### 422 - Validation Error

**HTTPValidationError**
- **detail** (array (ValidationError))
  Array items:
    - **loc** (array (union)) (required)
    - **msg** (string) (required)
    - **type** (string) (required)

#### 500 - Scraping failed

Scraping failed

### Example Usage

```bash
curl -X GET "https://api.example.com/pornpics/pornstars?orientation=string&gender=string&body=string&hair=string&tits=string&ethnicity=string&nationality=string&age=string&sort=popular&page=1"
```

```

--------------------------------

### GET /letsjerktv/pornstars

Source: https://api.adultdatalink.com/openapi.json

API endpoint for GET /letsjerktv/pornstars

```markdown
### Parameters

- **page** (integer, query, optional): Results page number. Valid range is (1, 100000) but no more than total_pages received in response.

### Responses

#### 200 - Successful Response


#### 404 - Not found

Not found

#### 422 - Validation Error

**HTTPValidationError**
- **detail** (array (ValidationError))
  Array items:
    - **loc** (array (union)) (required)
    - **msg** (string) (required)
    - **type** (string) (required)

### Example Usage

```bash
curl -X GET "https://api.example.com/letsjerktv/pornstars?page=1"
```

```

--------------------------------

### GET /pimpandhost/categories

Source: https://api.adultdatalink.com/openapi.json

API endpoint for GET /pimpandhost/categories

```markdown
### Parameters

- **filter_** (string, query, optional): Filter for categories, * = all, None = trending, letter = all tags that start with that letter

### Responses

#### 200 - Successful Response


#### 404 - Not found

Not found

#### 422 - Validation Error

**HTTPValidationError**
- **detail** (array (ValidationError))
  Array items:
    - **loc** (array (union)) (required)
    - **msg** (string) (required)
    - **type** (string) (required)

### Example Usage

```bash
curl -X GET "https://api.example.com/pimpandhost/categories?filter_=string"
```

```

--------------------------------

### GET /letsjerktv/categories

Source: https://api.adultdatalink.com/openapi.json

API endpoint for GET /letsjerktv/categories

```markdown
### Parameters

- **page** (integer, query, optional): Results page number. Valid range is (1, 100000) but no more than total_pages received in response.

### Responses

#### 200 - Successful Response


#### 404 - Not found

Not found

#### 422 - Validation Error

**HTTPValidationError**
- **detail** (array (ValidationError))
  Array items:
    - **loc** (array (union)) (required)
    - **msg** (string) (required)
    - **type** (string) (required)

### Example Usage

```bash
curl -X GET "https://api.example.com/letsjerktv/categories?page=1"
```

```

--------------------------------

### GET /sexstories/search

Source: https://api.adultdatalink.com/openapi.json

Search for stories based on specified criteria.

This endpoint allows searching for stories using various parameters such as keywords, category, genre, date range, and sorting options.

Parameters:
- request (Request): The FastAPI request object for logging and error handling.
- params (SearchRequest): Query parameters for the search, including:
    - page (int): Page number (starts at 1). Default: 1.
    - sort (str): Sort order. Options: relevance, name, rate, view, date. Default: relevance.
    - keywords (str, optional): Search keywords (e.g., 'Anal'). Default: "" (all stories).
    - category (str, optional): Category ID (e.g., '2' for Anal). See /sexstories/themes. Default: "".
    - genre (str, optional): Genre ID (e.g., '9' for Fantasy). See /sexstories/genres. Default: "".
    - date_begin (str, optional): Start date in YYYY-MM-DD format. Default: "".
    - date_end (str, optional): End date in YYYY-MM-DD format. Default: "".
    - type (str): Content type to search. Default: "stories".


Returns:
- Dict: A dictionary with:
    - results: List of matching stories or content.
    - metadata: Search parameters and metadata (e.g., page, total results, URL).

Raises:
- HTTPException:
    - 400: If invalid category, genre, or other parameters are provided.
    - 500: If an error occurs during scraping or processing (e.g., network issues).

Example:
```
GET /sexstories/search?page=1&sort=relevance&keywords=Anal&category=2&genre=9&date_begin=2024-04-17&date_end=2025-04-18
Response:
{
    "results": [
        {"title": "Story 1", "url": "...", "themes": ["2"], "genres": ["9"], ...},
        ...
    ],
    "metadata": {
        "page": 1,
        "total_results": 100,
        "search_url": "...",
        "parameters": {...}
    }
}
```

```markdown
### Parameters

- **page** (integer, query, optional)
- **sort** (string, query, optional)
- **keywords** (string, query, optional)
- **category** (string, query, optional)
- **genre** (string, query, optional)
- **date_begin** (string, query, optional)
- **date_end** (string, query, optional)
- **type** (string, query, optional)

### Responses

#### 200 - Successful Response

**SearchResponse**
- **results** (object)
- **metadata** (object) (required)

#### 404 - Not found

Not found

#### 422 - Validation Error

**HTTPValidationError**
- **detail** (array (ValidationError))
  Array items:
    - **loc** (array (union)) (required)
    - **msg** (string) (required)
    - **type** (string) (required)

### Example Usage

```bash
curl -X GET "https://api.example.com/sexstories/search?page=1&sort=relevance&keywords=&category=&genre=&date_begin=&date_end=&type=stories"
```

```

--------------------------------

### GET /sexstories/themes

Source: https://api.adultdatalink.com/openapi.json

Retrieve the list of available story themes.

This endpoint returns a dictionary of theme IDs and their corresponding names, useful for filtering stories by category.

Parameters:
- request (Request): The FastAPI request object for logging and error handling.


Returns:
- Dict: A dictionary mapping theme IDs to theme names (e.g., {"1": "Alien", "2": "Anal"}).
- None: If no themes are retrieved.

Raises:
- HTTPException:
    - 500: If an error occurs during scraping or processing (e.g., network issues, parsing errors).

Example:
```
GET /sexstories/themes
Response:
{
    "1": "Alien",
    "2": "Anal",
    ...
}
```

```markdown
### Responses

#### 200 - Successful Response


#### 404 - Not found

Not found

### Example Usage

```bash
curl -X GET "https://api.example.com/sexstories/themes"
```

```

--------------------------------

### GET /pimpandhost/pornstars

Source: https://api.adultdatalink.com/openapi.json

API endpoint for GET /pimpandhost/pornstars

```markdown
### Parameters

- **filter_** (string, query, optional): Filter for categories, None = trending, letter = all tags that start with that letter

### Responses

#### 200 - Successful Response


#### 404 - Not found

Not found

#### 422 - Validation Error

**HTTPValidationError**
- **detail** (array (ValidationError))
  Array items:
    - **loc** (array (union)) (required)
    - **msg** (string) (required)
    - **type** (string) (required)

### Example Usage

```bash
curl -X GET "https://api.example.com/pimpandhost/pornstars?filter_=string"
```

```

--------------------------------

### GET /pimpandhost/gifs

Source: https://api.adultdatalink.com/openapi.json

API endpoint for GET /pimpandhost/gifs

```markdown
### Parameters

- **page** (integer, query, optional): Number of results to return (max 100)
- **per_page** (integer, query, optional): Page number to return (positive integer)

### Responses

#### 200 - Successful Response


#### 404 - Not found

Not found

#### 422 - Validation Error

**HTTPValidationError**
- **detail** (array (ValidationError))
  Array items:
    - **loc** (array (union)) (required)
    - **msg** (string) (required)
    - **type** (string) (required)

### Example Usage

```bash
curl -X GET "https://api.example.com/pimpandhost/gifs?page=10&per_page=1"
```

```

--------------------------------

### GET /xhamster/category-results

Source: https://api.adultdatalink.com/openapi.json

Fetches photo gallery results for a given xHamster category, including gallery items, related videos, and pagination information.
    
    **Parameters**:
    - **category**: Required category name (e.g., 'algerian'). Spaces are replaced with dashes in the URL.
    - **page**: Page number for pagination (default: 1). Appended as /<page> if >1.
    - **orientation**: Orientation filter ('straight', 'gay', 'shemale'). Default: 'straight'.
    - **URL Example**: https://xhamster.com/photos/categories/algerian/2
    
    Results are cached for repeated queries.

```markdown
### Parameters

- **category** (string, query, required): Category name (e.g., 'algerian')
- **page** (integer, query, optional): Page number for pagination
- **orientation** (string, query, optional): Orientation: 'straight', 'gay', 'shemale'

### Responses

#### 200 - Successful response with category results


#### 400 - Invalid category or scraping error

#### 404 - Not found

Not found

#### 422 - Validation Error

**HTTPValidationError**
- **detail** (array (ValidationError))
  Array items:
    - **loc** (array (union)) (required)
    - **msg** (string) (required)
    - **type** (string) (required)

#### 500 - Internal server error

### Example Usage

```bash
curl -X GET "https://api.example.com/xhamster/category-results?category=string&page=1&orientation=straight"
```

```

--------------------------------

### GET /letsjerktv/search

Source: https://api.adultdatalink.com/openapi.json

API endpoint for GET /letsjerktv/search

```markdown
### Parameters

- **query** (string, query, optional): Search query for videos.
- **page** (integer, query, optional): Results page number. Valid range is (1, 100000) but no more than total_pages received in response.

### Responses

#### 200 - Successful Response


#### 404 - Not found

Not found

#### 422 - Validation Error

**HTTPValidationError**
- **detail** (array (ValidationError))
  Array items:
    - **loc** (array (union)) (required)
    - **msg** (string) (required)
    - **type** (string) (required)

### Example Usage

```bash
curl -X GET "https://api.example.com/letsjerktv/search?query=string&page=1"
```

```

--------------------------------

### GET /pornpics/gallery-image-links

Source: https://api.adultdatalink.com/openapi.json

Given a full gallery URL, returns **all direct image links** inside the gallery.
    Also includes metadata: views, rating, tags.

```markdown
### Parameters

- **gallery** (string, query, required): Full PornPics gallery URL

### Responses

#### 200 - Gallery images and metadata


#### 400 - Not a valid PornPics gallery or scraping failed

Not a valid PornPics gallery or scraping failed

#### 404 - Not found

Not found

#### 422 - Invalid or missing gallery URL

Invalid or missing gallery URL

### Example Usage

```bash
curl -X GET "https://api.example.com/pornpics/gallery-image-links?gallery=string"
```

```

--------------------------------

### GET /rule34/autocomplete

Source: https://api.adultdatalink.com/openapi.json

Retrieves tag autocomplete suggestions from Rule34.xxx.

```markdown
### Parameters

- **query** (string, query, optional): Partial tag to get autocomplete suggestions.

### Responses

#### 200 - Successful Response


#### 404 - Not found

Not found

#### 422 - Validation Error

**HTTPValidationError**
- **detail** (array (ValidationError))
  Array items:
    - **loc** (array (union)) (required)
    - **msg** (string) (required)
    - **type** (string) (required)

### Example Usage

```bash
curl -X GET "https://api.example.com/rule34/autocomplete?query=string"
```

```

--------------------------------

### GET /sexstories/story

Source: https://api.adultdatalink.com/openapi.json

Retrieve detailed information about a specific story.

This endpoint fetches details for a story identified by its URL, including title, content, author, and metadata.

Parameters:
- request (Request): The FastAPI request object for logging and error handling.
- story_url (str): The URL of the story to retrieve details for.


Returns:
- Dict: A dictionary containing story details (e.g., title, content, author, themes).
- None: If no story details are retrieved.

Raises:
- HTTPException:
    - 500: If an error occurs during scraping or processing (e.g., invalid URL, network issues).

Example:
```
GET /sexstories/story?story_url=https://example.com/story/12345
Response:
{
    "title": "Story Title",
    "content": "...",
    "author": "Author Name",
    "themes": ["2", "20"],
    "metadata": {...}
}
```

```markdown
### Parameters

- **story_url** (string, query, required)

### Responses

#### 200 - Successful Response


#### 404 - Not found

Not found

#### 422 - Validation Error

**HTTPValidationError**
- **detail** (array (ValidationError))
  Array items:
    - **loc** (array (union)) (required)
    - **msg** (string) (required)
    - **type** (string) (required)

### Example Usage

```bash
curl -X GET "https://api.example.com/sexstories/story?story_url=string"
```

```

--------------------------------

### GET /functions/stream-video

Source: https://api.adultdatalink.com/openapi.json

API endpoint for GET /functions/stream-video

```markdown
### Parameters

- **url** (string, query, required)

### Responses

#### 200 - Successful Response


#### 404 - Not found

Not found

#### 422 - Validation Error

**HTTPValidationError**
- **detail** (array (ValidationError))
  Array items:
    - **loc** (array (union)) (required)
    - **msg** (string) (required)
    - **type** (string) (required)

### Example Usage

```bash
curl -X GET "https://api.example.com/functions/stream-video?url=string"
```

```

--------------------------------

### GET /xnxx/best-videos

Source: https://api.adultdatalink.com/openapi.json

Fetch the best videos for a given date (YYYY-MM format).

Params:
    date: Date in YYYY-MM format (required).
    page_number: Page number for paginated results (optional).

```markdown
### Parameters

- **date** (string, query, required)
- **page_number** (integer, query, optional): Page number for paginated results (optional)

### Responses

#### 200 - Successful Response


#### 404 - Not found

Not found

#### 422 - Validation Error

**HTTPValidationError**
- **detail** (array (ValidationError))
  Array items:
    - **loc** (array (union)) (required)
    - **msg** (string) (required)
    - **type** (string) (required)

### Example Usage

```bash
curl -X GET "https://api.example.com/xnxx/best-videos?date=string&page_number=0"
```

```

--------------------------------

### GET /eporner/video

Source: https://api.adultdatalink.com/openapi.json

Retrieves image links from a specified gallery.

```markdown
### Parameters

- **video_id** (string, query, required): A string representing the gallery to scrape images from.
- **thumbsize** (string, query, optional): Thumbnails size. Valid values: 'small', 'medium', 'big'.
- **search_format** (string, query, optional): How results should be formatted? Valid values: 'json', 'xml'.

### Responses

#### 200 - Successful Response


#### 404 - Not found

Not found

#### 422 - Validation Error

**HTTPValidationError**
- **detail** (array (ValidationError))
  Array items:
    - **loc** (array (union)) (required)
    - **msg** (string) (required)
    - **type** (string) (required)

### Example Usage

```bash
curl -X GET "https://api.example.com/eporner/video?video_id=string&thumbsize=medium&search_format=json"
```

```

--------------------------------

### GET /pornpics/tags

Source: https://api.adultdatalink.com/openapi.json

Returns a dictionary of all supported PornPics tags loaded from the configuration file.
    Tags are used in `/tag-image-links` and other tag-based endpoints.

```markdown
### Responses

#### 200 - List of tags


#### 404 - Not found

Not found

#### 500 - Failed to load tags file

Failed to load tags file

### Example Usage

```bash
curl -X GET "https://api.example.com/pornpics/tags"
```

```

--------------------------------

### GET /sexstories/updates

Source: https://api.adultdatalink.com/openapi.json

Retrieve recent updates from the sex stories website.

This endpoint fetches a list of recently added or updated stories, optionally paginated by page number.

Parameters:
- request (Request): The FastAPI request object for logging and error handling.
- page_number (int, optional): The page number to retrieve (starts at 1). Defaults to None (first page).


Returns:
- Dict: A dictionary containing a list of recent story updates and metadata (e.g., pagination info).
- None: If no updates are retrieved.

Raises:
- HTTPException:
    - 500: If an error occurs during scraping or processing (e.g., network issues, parsing errors).

Example:
```
GET /sexstories/updates?page_number=2
Response:
{
    "updates": [...],
    "metadata": {"page": 2, "total_pages": 10}
}
```

```markdown
### Parameters

- **page_number** (integer, query, optional)

### Responses

#### 200 - Successful Response


#### 404 - Not found

Not found

#### 422 - Validation Error

**HTTPValidationError**
- **detail** (array (ValidationError))
  Array items:
    - **loc** (array (union)) (required)
    - **msg** (string) (required)
    - **type** (string) (required)

### Example Usage

```bash
curl -X GET "https://api.example.com/sexstories/updates?page_number=0"
```

```

--------------------------------

### GET /sexstories/authors

Source: https://api.adultdatalink.com/openapi.json

Retrieve a list of authors, filtered and paginated.

This endpoint fetches authors based on a specified filter (e.g., by rating, name, number of stories, or date) and page number.

Parameters:
- request (Request): The FastAPI request object for logging and error handling.
- filter_ (str): The filter to apply. Valid options: 'rate', 'name', 'nbstories', 'date'.
- page_number (int): The page number to retrieve (starts at 1). Defaults to 1.


Returns:
- Dict: A dictionary containing a list of authors and metadata (e.g., pagination info).
- None: If no authors are retrieved.

Raises:
- HTTPException:
    - 400: If an invalid filter is provided.
    - 500: If an error occurs during scraping or processing (e.g., network issues, parsing errors).

Example:
```
GET /sexstories/authors?filter_=rate&page_number=1
Response:
{
    "authors": [...],
    "metadata": {"filter": "rate", "page": 1, "total_pages": 5}
}
```

```markdown
### Parameters

- **filter_** (string, query, required)
- **page_number** (integer, query, optional)

### Responses

#### 200 - Successful Response


#### 404 - Not found

Not found

#### 422 - Validation Error

**HTTPValidationError**
- **detail** (array (ValidationError))
  Array items:
    - **loc** (array (union)) (required)
    - **msg** (string) (required)
    - **type** (string) (required)

### Example Usage

```bash
curl -X GET "https://api.example.com/sexstories/authors?filter_=string&page_number=1"
```

```

--------------------------------

### GET /pornhub/pornstar-information

Source: https://api.adultdatalink.com/openapi.json

Fetches comprehensive profile metadata for a Pornhub pornstar or model using their name. Automatically handles redirects between `/model/` and `/pornstar/` slugs. Includes name, avatar, cover image, ranks, stats (views, subscribers), bio, about text, social links, detailed info (measurements, height, gender, etc.), verification status, and award badges. Responses are cached for performance.

```markdown
### Parameters

- **name** (string, query, required): Name of the pornstar or model (e.g., 'angela white', 'crystal lust'). Spaces are converted to hyphens.

### Responses

#### 200 - Successful response with full profile metadata


#### 400 - Invalid name format

#### 404 - Profile not found

#### 422 - Validation Error

**HTTPValidationError**
- **detail** (array (ValidationError))
  Array items:
    - **loc** (array (union)) (required)
    - **msg** (string) (required)
    - **type** (string) (required)

#### 500 - Server error during data retrieval

### Example Usage

```bash
curl -X GET "https://api.example.com/pornhub/pornstar-information?name=string"
```

```

--------------------------------

### GET /pornstar/social-profiles

Source: https://api.adultdatalink.com/openapi.json

API endpoint for GET /pornstar/social-profiles

```markdown
### Parameters

- **name** (string, query, optional): Name of the pornstar to get profiles

### Responses

#### 200 - Successful Response


#### 404 - Not found

Not found

#### 422 - Validation Error

**HTTPValidationError**
- **detail** (array (ValidationError))
  Array items:
    - **loc** (array (union)) (required)
    - **msg** (string) (required)
    - **type** (string) (required)

### Example Usage

```bash
curl -X GET "https://api.example.com/pornstar/social-profiles?name=string"
```

```

--------------------------------

### GET /pornhub/pornstars

Source: https://api.adultdatalink.com/openapi.json

API endpoint for GET /pornhub/pornstars

```markdown
### Parameters

- **ordering** (string (trending|most_viewed|most_subscribed|alphabetical|num_videos|random), query, optional): Sort order
- **performer_type** (string (amateur|pornstar), query, optional)
- **gender** (string (all|male|female|trans_woman|trans_man), query, optional)
- **piercings** (string (all|yes|no), query, optional)
- **ethnicity** (string (all|asian|black|indian|latin|middle_eastern|mixed|white|other), query, optional)
- **hair_color** (string (all|auburn|bald|black|blonde|brunette|grey|red|various|other), query, optional)
- **tattoos** (string (all|yes|no), query, optional)
- **breast_type** (string (all|natural|fake), query, optional)
- **cup_size** (string (all|a|b|c|d|e|f_z), query, optional)
- **page** (integer, query, optional)

### Responses

#### 200 - Successful Response


#### 404 - Not found

Not found

#### 422 - Validation Error

**HTTPValidationError**
- **detail** (array (ValidationError))
  Array items:
    - **loc** (array (union)) (required)
    - **msg** (string) (required)
    - **type** (string) (required)

### Example Usage

```bash
curl -X GET "https://api.example.com/pornhub/pornstars?ordering=trending&performer_type=amateur&gender=all&piercings=all&ethnicity=all&hair_color=all&tattoos=all&breast_type=all&cup_size=all&page=1"
```

```

--------------------------------

### GET /pornhub/search

Source: https://api.adultdatalink.com/openapi.json

Search for videos with various filtering options.

This endpoint allows searching for videos using multiple parameters to filter and sort results.
Returns a JSON object containing an array of video objects under the 'videos' key.

Args:
    q (str): The search term to look for (required)
    page (int, optional): Page number for paginated results
    ordering (str, optional): How to sort the results. Options:
        - 'featured': Featured videos
        - 'newest': Most recent videos
        - 'mostviewed': Most viewed videos
        - 'rating': Highest rated videos
    thumbsize (str, optional): Size of returned thumbnails. Options:
        - 'small': Small size
        - 'medium': Medium size
        - 'large': Large size
        - 'small_hd': Small HD
        - 'medium_hd': Medium HD
        - 'large_hd': Large HD
    category (str, optional): Filter by specific category
    phrase (List[str], optional): Filter by specific pornstars
    tags (List[str], optional): Filter by specific tags
    period (str, optional): Time period for ordered results. Options:
        - 'weekly': Last week
        - 'monthly': Last month
        - 'alltime': All time

Returns:
    Dict: JSON response containing:
        - videos: List of video objects, each containing:
            - title: Video title
            - duration: Length in MM:SS format
            - views: Number of views
            - video_id: Unique video identifier
            - rating: Rating percentage
            - ratings: Number of ratings
            - url: Video URL
            - default_thumb: Default thumbnail URL
            - thumb: Primary thumbnail URL
            - publish_date: ISO format publication date
            - segment: Video segment
            - thumbs: List of thumbnail objects (size, width, height, src)
            - tags: List of tag names
            - categories: List of category names
            - pornstars: List of pornstar names

Raises:
    HTTPException: 400 if invalid parameter values are provided
    HTTPException: 500 if there's an internal server error

Example:
    GET /search?q=test&ordering=mostviewed&period=weekly&tags=["tag1"]

```markdown
### Parameters

- **q** (string, query, required): Search query string (required)
- **page** (integer, query, optional): Page number for pagination (e.g., 1, 2, 3)
- **ordering** (string (featured|newest|mostviewed|rating), query, optional): Sort order of results
- **thumbsize** (string (small|medium|large|small_hd|medium_hd|large_hd), query, optional): Size of thumbnail images
- **category** (string, query, optional): Filter by specific category
- **phrase** (array (string), query, optional): List of pornstar names to filter by (e.g., ['Star Name'])
- **tags** (array (string), query, optional): List of tags to filter by (e.g., ['tag1', 'tag2'])
- **period** (string (weekly|monthly|alltime), query, optional): Time period for ordered results (only works with ordering)

### Responses

#### 200 - Successful Response


#### 404 - Not found

Not found

#### 422 - Validation Error

**HTTPValidationError**
- **detail** (array (ValidationError))
  Array items:
    - **loc** (array (union)) (required)
    - **msg** (string) (required)
    - **type** (string) (required)

### Example Usage

```bash
curl -X GET "https://api.example.com/pornhub/search?q=string&page=0&ordering=featured&thumbsize=small&category=string&phrase=item1,item2&tags=item1,item2&period=weekly"
```

```

--------------------------------

### GET /pimpandhost/trending-images

Source: https://api.adultdatalink.com/openapi.json

API endpoint for GET /pimpandhost/trending-images

```markdown
### Responses

#### 200 - Successful Response


#### 404 - Not found

Not found

### Example Usage

```bash
curl -X GET "https://api.example.com/pimpandhost/trending-images"
```

```

--------------------------------

### Schema: Quickie

Source: https://api.adultdatalink.com/openapi.json

Schema definition for Quickie

```markdown
## Schema: Quickie

Schema definition for Quickie

**Type:** object

- **title** (string) (required)
- **url** (string) (required)
- **thumbnail** (string) (required)

```

--------------------------------

### GET /xhamster/videos

Source: https://api.adultdatalink.com/openapi.json

Fetches a list of videos from xHamster based on filters like category, quality, sort, etc.
    
    **Filtering Rules**:
    - Default: Trending videos (main page).
    - Category: 'hd', '4k', 'vr' (path: /hd, /4k, /vr).
    - Full length: Adds '/full-length' to URL (e.g., /hd/full-length).
    - Sort: 'newest' (/newest), 'best' (/best/<period>), 'most-viewed' (/most-viewed/<period>), 'most-commented' (/most-commented/<period>).
    - Period: 'weekly' (default), 'monthly', 'daily', 'year-2025'.
    - Quality: Query param ?quality=1080p etc. (for hd/vr).
    - FPS: ?fps=30 etc.
    - Duration: ?min-duration=10&max-duration=30.
    - VR-specific: ?angle=180&dimension=3d.
    - Pagination: /<page> if page >1.
    
    Results are cached for repeated queries.

```markdown
### Parameters

- **page** (integer, query, optional): Page number for pagination
- **category** (string, query, optional): Category: 'hd', '4k', 'vr'
- **quality** (string, query, optional): Quality: '1080p', '1440p', '1920p' etc.
- **fps** (integer, query, optional): FPS: 30, 60 etc.
- **sort** (string, query, optional): Sort: 'newest', 'best', 'most-viewed', 'most-commented'
- **period** (string, query, optional): Period: 'weekly', 'monthly', 'daily', 'year-2025'
- **full_length** (boolean, query, optional): Full length videos
- **min_duration** (integer, query, optional): Min duration (minutes)
- **max_duration** (integer, query, optional): Max duration (minutes)
- **angle** (integer, query, optional): VR angle: 180, 360
- **dimension** (string, query, optional): VR dimension: '2d', '3d'

### Responses

#### 200 - List of videos with metadata


#### 400 - Invalid parameters or scraping error

#### 404 - Not found

Not found

#### 422 - Validation Error

**HTTPValidationError**
- **detail** (array (ValidationError))
  Array items:
    - **loc** (array (union)) (required)
    - **msg** (string) (required)
    - **type** (string) (required)

#### 500 - Internal server error

Internal server error

### Example Usage

```bash
curl -X GET "https://api.example.com/xhamster/videos?page=1&category=&quality=&fps=0&sort=&period=weekly&full_length=false&min_duration=0&max_duration=0&angle=0&dimension=string"
```

```

--------------------------------

### GET /xvideos/search

Source: https://api.adultdatalink.com/openapi.json

Searches Xvideos for videos based on a query string with optional filters for sorting, duration, quality, and date.
    Results are cached to improve performance for repeated requests. The endpoint returns a list of video metadata.

    **Parameters**:
    - **search_query**: The search term (e.g., 'Mia Khalifa'). Required.
    - **sort**: Sorting option. Valid values: 'relevance', 'uploaddate' (Newest), 'rating', 'length', 'views', 'random'. Defaults to None.
    - **durf**: Duration filter. Valid values: 'allduration', '1-3min' (Short videos), '3-10min' (Medium videos), '10-20min' (Long videos), '20min+' (Long videos). Defaults to None.
    - **quality**: Quality filter (e.g., 'all', 'hd', '1080P'). Defaults to None.
    - **datef**: Date filter (e.g., 'today', 'week', 'month'). Defaults to None.
    - **p**: Page filter (e.g., '1', '2', '20', '132'). Defaults to None.

    **Returns**:
    - A list of video metadata objects containing details such as title, duration, thumbnail URL, and video URL.

    **Raises**:
    - **HTTPException (422)**: If the search query is not specified.
    - **HTTPException (400)**: If invalid parameters are provided.

```markdown
### Parameters

- **search_query** (string, query, optional): Search query (e.g., Mia Khalifa). Required
- **sort** (string, query, optional): Sorting option. Valid values: relevance, uploaddate (Newest), rating, length, views, random
- **durf** (string, query, optional): Duration filter. Valid values: allduration, 1-3min (Short videos), 3-10min (Medium videos), 10-20min (Long videos), 20min+ (Long videos)
- **quality** (string, query, optional): Quality filter (e.g., all, hd, 1080P)
- **datef** (string, query, optional): Date filter (e.g., today, week, month)
- **p** (integer, query, optional): Page filter (e.g., 1, 2, 20, 132)

### Responses

#### 200 - Successful response with search results


#### 400 - Invalid parameters or error

#### 404 - Not found

Not found

#### 422 - Search query not specified

### Example Usage

```bash
curl -X GET "https://api.example.com/xvideos/search?search_query=&sort=string&durf=string&quality=string&datef=string&p=0"
```

```