> ## Documentation Index
> Fetch the complete documentation index at: https://composio-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Pexels

> Pexels offers a free API that provides access to a vast library of high-quality photos and videos, enabling seamless integration into applications and websites.

![Pexels logo](https://mintcdn.com/composio-preview/gqjBKmmJCINafaiK/images/toolkits/pexels.svg?fit=max\&auto=format\&n=gqjBKmmJCINafaiK\&q=85\&s=d8e76c496aef6149686931ad9c76db7b)

* **Category:** images & design
* **Auth:** API\_KEY
* **Composio-managed OAuth available?** N/A
* **Tools:** 9
* **Triggers:** 0
* **Slug:** `PEXELS`
* **Version:** 20261101\_00

## Tools

> [accordion] Get Collection Media
>
> **Slug:** `PEXELS_COLLECTION_MEDIA`
>
> Retrieve a page of photos and videos from a Pexels collection by ID. The collection must be featured or belong to the authenticated user. Choose a page and page size, up to 80 items per page; the default is 15.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> The unique identifier of the Pexels collection.
>
> **page** `integer`
>
> Page number for pagination, must be >= 1.
>
> **per\_page** `integer`
>
> Number of results per page (1-80).
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Curated Photos
>
> **Slug:** `PEXELS_CURATED_PHOTOS`
>
> Tool to get real-time curated photos. Use when you need to fetch curated photos with pagination support.
>
> #### Input Parameters
>
> **page** `integer`
>
> Page number to retrieve (min 1). Defaults to Pexels API default of 1.
>
> **per\_page** `integer`
>
> Number of results per page (min 1, max 80). Defaults to Pexels API default of 15.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Featured Collections
>
> **Slug:** `PEXELS_FEATURED_COLLECTIONS`
>
> Tool to get featured collections. Use when you need curated collections of photos and videos with pagination support.
>
> #### Input Parameters
>
> **page** `integer`
>
> Page number of results to retrieve, must be >= 1.
>
> **per\_page** `integer`
>
> Number of results per page (1-80). Defaults to 15.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Photo
>
> **Slug:** `PEXELS_GET_PHOTO`
>
> Tool to retrieve detailed information about a specific photo. Use when you have a valid photo ID to fetch metadata including dimensions, photographer details, and image URLs. Use after confirming the photo ID from search or curated endpoints.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The unique identifier of the photo to retrieve
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Video by ID
>
> **Slug:** `PEXELS_GET_VIDEO_BY_ID`
>
> Retrieve details of a Pexels video by ID, including dimensions, duration, videographer information and available file versions. DEPRECATED: This action uses the older video endpoint, which Pexels says will be deprecated in the future; use the /v1/videos/videos/:id endpoint instead.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The unique identifier of the video to retrieve
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get My Collections
>
> **Slug:** `PEXELS_MY_COLLECTIONS`
>
> List the authenticated user's Pexels collections, including collection details and media counts. Choose a page and page size, up to 80 collections per page; the default is 15.
>
> #### Input Parameters
>
> **page** `integer`
>
> Page number to retrieve, must be >= 1
>
> **per\_page** `integer`
>
> Number of collections per page, between 1 and 80
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Popular Videos
>
> **Slug:** `PEXELS_POPULAR_VIDEOS`
>
> Retrieve a page of current popular Pexels videos for discovering trending content. Choose a page and page size, up to 80 videos per page; the default is 15.
>
> #### Input Parameters
>
> **page** `integer`
>
> Page number to retrieve. Default is 1.
>
> **per\_page** `integer`
>
> Number of videos per page (1–80). Default is 15.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Search Photos
>
> **Slug:** `PEXELS_SEARCH_PHOTOS`
>
> Tool to search for photos on Pexels. Use when you need to retrieve photos by a search term and optional filters. Call after confirming you have a valid Pexels API key. Response image URLs are nested under `photo.src.<size>` (e.g., `photo.src.original`, `photo.src.landscape`, `photo.src.medium`); the top-level `url` field is not sufficient for accessing specific image sizes.
>
> #### Input Parameters
>
> **page** `integer`
>
> Page number of results to retrieve, must be >= 1.
>
> **size** `string ("large" | "medium" | "small")`
>
> Filter by photo size.
>
> **color** `string`
>
> Filter by photo color. Accepts standard color names or hex codes, e.g., 'red' or '#00ff00'.
>
> **query** `string` *required*
>
> Search term to find photos. Use specific, descriptive terms (e.g., 'plated chicken overhead shot' instead of 'chicken') to improve result relevance.
>
> **locale** `string`
>
> Language locale for search results, e.g., 'en-US', 'pt-BR'.
>
> **per\_page** `integer`
>
> Number of results per page (1-80). Defaults to 15.
>
> **orientation** `string ("landscape" | "portrait" | "square")`
>
> Filter by photo orientation.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Search Videos
>
> **Slug:** `PEXELS_SEARCH_VIDEOS`
>
> Search Pexels videos by query, optionally filtering by orientation and minimum size. Results are paginated, with 15 per page by default and a maximum of 80. DEPRECATED: This action uses the older video endpoint, which Pexels says will be deprecated in the future; use the /v1/videos/search endpoint instead.
>
> #### Input Parameters
>
> **page** `integer`
>
> Page number for paginated results (starting at 1)
>
> **size** `string ("large" | "medium" | "small")`
>
> Filter results by video size
>
> **query** `string` *required*
>
> Search query term for finding relevant videos
>
> **per\_page** `integer`
>
> Number of results per page (min 1, max 80) Keep close to default when only a few results are needed to avoid oversized responses.
>
> **orientation** `string ("landscape" | "portrait" | "square")`
>
> Filter results by video orientation
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not
