Skip to main content
Pexels logo
  • Category: images & design
  • Auth: API_KEY
  • Composio-managed OAuth available? N/A
  • Tools: 9
  • Triggers: 0
  • Slug: PEXELS
  • Version: 20261101_00

Tools

Slug: PEXELS_COLLECTION_MEDIARetrieve 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

string
required
The unique identifier of the Pexels collection.
integer
Page number for pagination, must be >= 1.
integer
Number of results per page (1-80).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PEXELS_CURATED_PHOTOSTool to get real-time curated photos. Use when you need to fetch curated photos with pagination support.

Input Parameters

integer
Page number to retrieve (min 1). Defaults to Pexels API default of 1.
integer
Number of results per page (min 1, max 80). Defaults to Pexels API default of 15.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PEXELS_GET_PHOTOTool 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

integer
required
The unique identifier of the photo to retrieve

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PEXELS_GET_VIDEO_BY_IDRetrieve 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

integer
required
The unique identifier of the video to retrieve

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PEXELS_MY_COLLECTIONSList 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

integer
Page number to retrieve, must be >= 1
integer
Number of collections per page, between 1 and 80

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PEXELS_SEARCH_PHOTOSTool 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

integer
Page number of results to retrieve, must be >= 1.
string ("large" | "medium" | "small")
Filter by photo size.
string
Filter by photo color. Accepts standard color names or hex codes, e.g., ‘red’ or ‘#00ff00’.
string
required
Search term to find photos. Use specific, descriptive terms (e.g., ‘plated chicken overhead shot’ instead of ‘chicken’) to improve result relevance.
string
Language locale for search results, e.g., ‘en-US’, ‘pt-BR’.
integer
Number of results per page (1-80). Defaults to 15.
string ("landscape" | "portrait" | "square")
Filter by photo orientation.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PEXELS_SEARCH_VIDEOSSearch 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

integer
Page number for paginated results (starting at 1)
string ("large" | "medium" | "small")
Filter results by video size
string
required
Search query term for finding relevant videos
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.
string ("landscape" | "portrait" | "square")
Filter results by video orientation

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not