> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pinkfish.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# pexels

> Pexels Stock Media

**Server path:** `/pexels` | **Type:** Application | **PCID required:** Yes

## Tools

| Tool                                                                  | Description                              |
| --------------------------------------------------------------------- | ---------------------------------------- |
| [`pexels_get_collection_media`](#pexels_get_collection_media)         | Get media in a collection                |
| [`pexels_get_curated_photos`](#pexels_get_curated_photos)             | Get curated photos                       |
| [`pexels_get_featured_collections`](#pexels_get_featured_collections) | Get featured collections                 |
| [`pexels_get_my_collections`](#pexels_get_my_collections)             | Get the authenticated user's collections |
| [`pexels_get_photo`](#pexels_get_photo)                               | Get a photo by ID                        |
| [`pexels_get_popular_videos`](#pexels_get_popular_videos)             | Get popular videos                       |
| [`pexels_get_video`](#pexels_get_video)                               | Get a video by ID                        |
| [`pexels_search_photos`](#pexels_search_photos)                       | Search photos                            |
| [`pexels_search_videos`](#pexels_search_videos)                       | Search videos                            |

***

## pexels\_get\_collection\_media

Get media in a collection

**Parameters:**

| Parameter  | Type    | Required | Default | Description                                                 |
| ---------- | ------- | -------- | ------- | ----------------------------------------------------------- |
| `id`       | string  | Yes      | —       | The Pexels collection ID.                                   |
| `type`     | string  | No       | —       | Filter the media type returned in the collection.           |
| `sort`     | string  | No       | —       | Sort order for the media in the collection.                 |
| `page`     | integer | No       | —       | The page number to return. Defaults to 1.                   |
| `per_page` | integer | No       | —       | The number of results per page. Defaults to 15, maximum 80. |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "id": {
        "type": "string",
        "description": "The Pexels collection ID."
      },
      "type": {
        "type": "string",
        "description": "Filter the media type returned in the collection.",
        "enum": [
          "photos",
          "videos"
        ]
      },
      "sort": {
        "type": "string",
        "description": "Sort order for the media in the collection.",
        "enum": [
          "asc",
          "desc"
        ]
      },
      "page": {
        "type": "integer",
        "description": "The page number to return. Defaults to 1."
      },
      "per_page": {
        "type": "integer",
        "description": "The number of results per page. Defaults to 15, maximum 80."
      }
    },
    "required": [
      "PCID",
      "id"
    ]
  }
  ```
</Expandable>

***

## pexels\_get\_curated\_photos

Get curated photos

**Parameters:**

| Parameter  | Type    | Required | Default | Description                                                 |
| ---------- | ------- | -------- | ------- | ----------------------------------------------------------- |
| `page`     | integer | No       | —       | The page number to return. Defaults to 1.                   |
| `per_page` | integer | No       | —       | The number of results per page. Defaults to 15, maximum 80. |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "page": {
        "type": "integer",
        "description": "The page number to return. Defaults to 1."
      },
      "per_page": {
        "type": "integer",
        "description": "The number of results per page. Defaults to 15, maximum 80."
      }
    },
    "required": [
      "PCID"
    ]
  }
  ```
</Expandable>

***

## pexels\_get\_featured\_collections

Get featured collections

**Parameters:**

| Parameter  | Type    | Required | Default | Description                                                 |
| ---------- | ------- | -------- | ------- | ----------------------------------------------------------- |
| `page`     | integer | No       | —       | The page number to return. Defaults to 1.                   |
| `per_page` | integer | No       | —       | The number of results per page. Defaults to 15, maximum 80. |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "page": {
        "type": "integer",
        "description": "The page number to return. Defaults to 1."
      },
      "per_page": {
        "type": "integer",
        "description": "The number of results per page. Defaults to 15, maximum 80."
      }
    },
    "required": [
      "PCID"
    ]
  }
  ```
</Expandable>

***

## pexels\_get\_my\_collections

Get the authenticated user's collections

**Parameters:**

| Parameter  | Type    | Required | Default | Description                                                 |
| ---------- | ------- | -------- | ------- | ----------------------------------------------------------- |
| `page`     | integer | No       | —       | The page number to return. Defaults to 1.                   |
| `per_page` | integer | No       | —       | The number of results per page. Defaults to 15, maximum 80. |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "page": {
        "type": "integer",
        "description": "The page number to return. Defaults to 1."
      },
      "per_page": {
        "type": "integer",
        "description": "The number of results per page. Defaults to 15, maximum 80."
      }
    },
    "required": [
      "PCID"
    ]
  }
  ```
</Expandable>

***

## pexels\_get\_photo

Get a photo by ID

**Parameters:**

| Parameter | Type    | Required | Default | Description          |
| --------- | ------- | -------- | ------- | -------------------- |
| `id`      | integer | Yes      | —       | The Pexels photo ID. |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "id": {
        "type": "integer",
        "description": "The Pexels photo ID."
      }
    },
    "required": [
      "PCID",
      "id"
    ]
  }
  ```
</Expandable>

***

## pexels\_get\_popular\_videos

Get popular videos

**Parameters:**

| Parameter      | Type    | Required | Default | Description                                                 |
| -------------- | ------- | -------- | ------- | ----------------------------------------------------------- |
| `min_width`    | integer | No       | —       | The minimum width in pixels of the returned videos.         |
| `min_height`   | integer | No       | —       | The minimum height in pixels of the returned videos.        |
| `min_duration` | integer | No       | —       | The minimum duration in seconds of the returned videos.     |
| `max_duration` | integer | No       | —       | The maximum duration in seconds of the returned videos.     |
| `page`         | integer | No       | —       | The page number to return. Defaults to 1.                   |
| `per_page`     | integer | No       | —       | The number of results per page. Defaults to 15, maximum 80. |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "min_width": {
        "type": "integer",
        "description": "The minimum width in pixels of the returned videos."
      },
      "min_height": {
        "type": "integer",
        "description": "The minimum height in pixels of the returned videos."
      },
      "min_duration": {
        "type": "integer",
        "description": "The minimum duration in seconds of the returned videos."
      },
      "max_duration": {
        "type": "integer",
        "description": "The maximum duration in seconds of the returned videos."
      },
      "page": {
        "type": "integer",
        "description": "The page number to return. Defaults to 1."
      },
      "per_page": {
        "type": "integer",
        "description": "The number of results per page. Defaults to 15, maximum 80."
      }
    },
    "required": [
      "PCID"
    ]
  }
  ```
</Expandable>

***

## pexels\_get\_video

Get a video by ID

**Parameters:**

| Parameter | Type    | Required | Default | Description          |
| --------- | ------- | -------- | ------- | -------------------- |
| `id`      | integer | Yes      | —       | The Pexels video ID. |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "id": {
        "type": "integer",
        "description": "The Pexels video ID."
      }
    },
    "required": [
      "PCID",
      "id"
    ]
  }
  ```
</Expandable>

***

## pexels\_search\_photos

Search photos

**Parameters:**

| Parameter     | Type    | Required | Default | Description                                                                                                                                                                |
| ------------- | ------- | -------- | ------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `query`       | string  | Yes      | —       | The search query (e.g. "Ocean", "Tigers", "Pears").                                                                                                                        |
| `orientation` | string  | No       | —       | Desired photo orientation.                                                                                                                                                 |
| `size`        | string  | No       | —       | Minimum photo size.                                                                                                                                                        |
| `color`       | string  | No       | —       | Desired photo color. Supports common color names (red, orange, yellow, green, turquoise, blue, violet, pink, brown, black, gray, white) or any hex color (e.g. "#ffa500"). |
| `locale`      | string  | No       | —       | Locale of the search query (e.g. "en-US", "pt-BR", "es-ES", "ja-JP").                                                                                                      |
| `page`        | integer | No       | —       | The page number to return. Defaults to 1.                                                                                                                                  |
| `per_page`    | integer | No       | —       | The number of results per page. Defaults to 15, maximum 80.                                                                                                                |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "query": {
        "type": "string",
        "description": "The search query (e.g. \"Ocean\", \"Tigers\", \"Pears\")."
      },
      "orientation": {
        "type": "string",
        "description": "Desired photo orientation.",
        "enum": [
          "landscape",
          "portrait",
          "square"
        ]
      },
      "size": {
        "type": "string",
        "description": "Minimum photo size.",
        "enum": [
          "large",
          "medium",
          "small"
        ]
      },
      "color": {
        "type": "string",
        "description": "Desired photo color. Supports common color names (red, orange, yellow, green, turquoise, blue, violet, pink, brown, black, gray, white) or any hex color (e.g. \"#ffa500\")."
      },
      "locale": {
        "type": "string",
        "description": "Locale of the search query (e.g. \"en-US\", \"pt-BR\", \"es-ES\", \"ja-JP\")."
      },
      "page": {
        "type": "integer",
        "description": "The page number to return. Defaults to 1."
      },
      "per_page": {
        "type": "integer",
        "description": "The number of results per page. Defaults to 15, maximum 80."
      }
    },
    "required": [
      "PCID",
      "query"
    ]
  }
  ```
</Expandable>

***

## pexels\_search\_videos

Search videos

**Parameters:**

| Parameter     | Type    | Required | Default | Description                                                           |
| ------------- | ------- | -------- | ------- | --------------------------------------------------------------------- |
| `query`       | string  | Yes      | —       | The search query (e.g. "Ocean", "Tigers", "Pears").                   |
| `orientation` | string  | No       | —       | Desired video orientation.                                            |
| `size`        | string  | No       | —       | Minimum video size.                                                   |
| `locale`      | string  | No       | —       | Locale of the search query (e.g. "en-US", "pt-BR", "es-ES", "ja-JP"). |
| `page`        | integer | No       | —       | The page number to return. Defaults to 1.                             |
| `per_page`    | integer | No       | —       | The number of results per page. Defaults to 15, maximum 80.           |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "query": {
        "type": "string",
        "description": "The search query (e.g. \"Ocean\", \"Tigers\", \"Pears\")."
      },
      "orientation": {
        "type": "string",
        "description": "Desired video orientation.",
        "enum": [
          "landscape",
          "portrait",
          "square"
        ]
      },
      "size": {
        "type": "string",
        "description": "Minimum video size.",
        "enum": [
          "large",
          "medium",
          "small"
        ]
      },
      "locale": {
        "type": "string",
        "description": "Locale of the search query (e.g. \"en-US\", \"pt-BR\", \"es-ES\", \"ja-JP\")."
      },
      "page": {
        "type": "integer",
        "description": "The page number to return. Defaults to 1."
      },
      "per_page": {
        "type": "integer",
        "description": "The number of results per page. Defaults to 15, maximum 80."
      }
    },
    "required": [
      "PCID",
      "query"
    ]
  }
  ```
</Expandable>