# Pexels AI integration on Definable

> 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.

## What this connects

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.

Vendor: https://www.pexels.com/api/

## Tools available

**9** tools available. First 9:

- `PEXELS_COLLECTION_MEDIA` — Get Collection Media — Tool to get all media within a collection by its ID. Use when you need to fetch paginated media from a specific collection.
- `PEXELS_CURATED_PHOTOS` — Get Curated Photos — Tool to get real-time curated photos. Use when you need to fetch curated photos with pagination support.
- `PEXELS_FEATURED_COLLECTIONS` — Featured Collections — Tool to get featured collections. Use when you need curated collections of photos and videos with pagination support.
- `PEXELS_GET_PHOTO` — 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.
- `PEXELS_GET_VIDEO_BY_ID` — Get Video by ID — Tool 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.
- `PEXELS_MY_COLLECTIONS` — Get My Collections — Tool to get all of the user's collections on Pexels. Use when you need to list a user's collections with pagination support.
- `PEXELS_POPULAR_VIDEOS` — Get Popular Videos — Tool to retrieve current popular Pexels videos. Use when you want to fetch trending videos from Pexels.
- `PEXELS_SEARCH_PHOTOS` — 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.
- `PEXELS_SEARCH_VIDEOS` — Search Videos — Tool 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.

## Auth

Auth schemes: `API_KEY`.

## How agents use Pexels

Inside a Definable workflow, Pexels is one of the tools the **Distributor specialist** can call. Example coordination patterns:

- **Researcher → Pexels** — the Researcher (GPT-5.5) pulls context from Pexels (records, threads, documents), synthesises findings, and briefs the rest of the team.
- **Writer → Distributor → Pexels** — the Writer (Claude Opus 4.7) drafts copy in brand voice, the Verifier passes it, then the Distributor writes the result into Pexels (create record, post message, draft email).
- **Designer / Engineer → Distributor → Pexels** — the Designer ships an asset or the Engineer ships a code change, the Distributor delivers it via Pexels (attach file, open PR comment, post status).

The Verifier checks every Pexels call. On rate limit, schema drift, or auth refresh it self-heals and retries — the workflow completes without manual intervention.

## Categories

- images & design — https://definable.ai/apps/category/images-&-design/

## Related

- HTML page: https://definable.ai/apps/pexels/
- Same category (images & design): https://definable.ai/apps/category/images-&-design/
- All integrations: https://definable.ai/apps/
- Workflow (multi-agent loop): https://definable.ai/workflow/
- Apps llms.txt index: https://definable.ai/llms-apps.txt
