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 offers a free API that provides access to a vast library of high-quality photos and videos, enabling seamless integration into applications and websites. On Nagent, Pexels is exposed as a fully-configurable images & design integration that any agent can call — 9 actions, and API key authentication. No code is required to wire Pexels into your workflow — connect it once via the External Integrations panel and reuse it across every agent you build.
Agent builders use Pexels to automate the kinds of tasks images & design teams previously handled manually. Concrete examples — each one is a single agent step in Nagent — include:
Every action and trigger is paired with a structured input/output schema (visible in the sections below), so when you wire Pexels into Helix — our agentic agent builder — the editor knows exactly what each step expects and produces. Configure once, deploy anywhere across your Nagent agents.
Every operation an agent can call against Pexels, with input parameters and output schema. Drop these into any step of an agent built in Helix.
PEXELS_COLLECTION_MEDIATool to get all media within a collection by its ID. Use when you need to fetch paginated media from a specific collection.
Input parameters
The unique identifier of the Pexels collection.
Page number for pagination, must be >= 1.
Number of results per page (1-80).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
PEXELS_CURATED_PHOTOSTool to get real-time curated photos. Use when you need to fetch curated photos with pagination support.
Input parameters
Page number to retrieve (min 1). Defaults to Pexels API default of 1.
Number of results per page (min 1, max 80). Defaults to Pexels API default of 15.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
PEXELS_FEATURED_COLLECTIONSTool to get featured collections. Use when you need curated collections of photos and videos with pagination support.
Input parameters
Page number of results to retrieve, must be >= 1.
Number of results per page (1-80). Defaults to 15.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
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
The unique identifier of the photo to retrieve
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
PEXELS_GET_VIDEO_BY_IDTool to retrieve detailed information about a specific video from Pexels. Use when you have a valid video ID to fetch metadata including dimensions, duration, videographer details, and available video file versions.
Input parameters
The unique identifier of the video to retrieve
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
PEXELS_MY_COLLECTIONSTool to get all of the user's collections on Pexels. Use when you need to list a user's collections with pagination support.
Input parameters
Page number to retrieve, must be >= 1
Number of collections per page, between 1 and 80
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
PEXELS_POPULAR_VIDEOSTool to retrieve current popular Pexels videos. Use when you want to fetch trending videos from Pexels.
Input parameters
Page number to retrieve. Default is 1.
Number of videos per page (1–80). Default is 15.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
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
Page number of results to retrieve, must be >= 1.
Filter by photo size.
Filter by photo color. Accepts standard color names or hex codes, e.g., 'red' or '#00ff00'.
Search term to find photos. Use specific, descriptive terms (e.g., 'plated chicken overhead shot' instead of 'chicken') to improve result relevance.
Language locale for search results, e.g., 'en-US', 'pt-BR'.
Number of results per page (1-80). Defaults to 15.
Filter by photo orientation.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
PEXELS_SEARCH_VIDEOSTool to search for videos on Pexels by query and optional filters. Use when you need to find relevant video assets. Combining multiple filters with a narrow query may return few or no results; only apply strict filter combinations when explicitly required.
Input parameters
Page number for paginated results (starting at 1)
Filter results by video size
Search query term for finding relevant videos
Number of results per page (min 1, max 80) Keep close to default when only a few results are needed to avoid oversized responses.
Filter results by video orientation
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
No publicly available marketplace agent is found using this tool yet. There are 89 agents privately built on Nagent that already use Pexels.
Build on Nagent
Connect Pexels to any Nagent agent in minutes — no API key management, no boilerplate. Just configure and deploy.
The five questions agent builders ask before adopting a new integration.
Open the External Integrations panel inside Nagent (app.nagent.ai/externalIntegration), find Pexels, and click "Connect Now." You'll authenticate with an API key — Nagent handles credential storage and refresh automatically. Once connected, Pexels is available to any agent in your workspace.
No. Nagent provides no-code integration for every tool. Once Pexels is connected, you configure its 9 actions directly in the agent builder UI — no API calls, no boilerplate, no schema management.
Helix — Nagent's agentic agent builder — lets you drop Pexels steps into any workflow visually. Pick an action (e.g., one of those listed above), fill in the inputs (Helix knows the required vs. optional schema for each parameter), and connect it to upstream/downstream steps. Triggers run as the entry point of an agent, so when a Pexels event fires, the agent kicks off automatically.
Every Pexels action and trigger ships with a fully-typed schema — input parameters with name, type, required flag, and description, plus the output payload shape. The schemas are documented in the sections above. Helix uses these schemas to validate your configuration at build time and to type-check the data flowing between steps.
Yes. While Pexels ships with 9 pre-built images & design actions, you can layer custom logic around them inside Helix — pre/post-processing steps, conditional branches, retries, or stitching Pexels together with other connected tools. For deeper customization, talk to our team about Nagent's Agentic AI Lab — forward-deployed engineers who build Pexels-based workflows tailored to your business.