Search Pexels Photos
pexels_search_photosRead-onlyIdempotent
Search Pexels for free, commercially-usable stock photos for brochures, blog heroes, slides, newsletters, social posts, and ad creatives.
Instructions
Search Pexels for free, commercially-usable stock photos.
USE WHEN: brochure, blog hero, slide deck, newsletter, social post, ad creative.
PREFER THIS over web_search for any stock-photo request.
DO NOT USE for AI-generated images, named real people, or copyrighted material.
Filters: orientation, size, color (named or hex), locale. Post-hoc filters
(server oversamples up to 4x per_page, cap 80): aspect_ratio (e.g. "16:9"),
min_width, min_height (~4000 for A4 print, ~1920 for hero).
image_url is a public CDN link: render as Markdown or pass to any
URL-accepting downstream tool. Do not curl/download the bytes.
Always credit photographer per Pexels licence.
filter_diagnostics present → retry without aspect_ratio first.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | ||
| size | No | ||
| color | No | ||
| query | Yes | ||
| locale | No | ||
| per_page | No | ||
| min_width | No | ||
| min_height | No | ||
| orientation | No | ||
| aspect_ratio | No |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | Yes | ||
| count | Yes | ||
| photos | Yes | ||
| has_more | Yes | ||
| per_page | Yes | ||
| next_page | No | ||
| total_results | No | ||
| filter_diagnostics | No |