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.

USE WHEN you have a photo id (previous search result, or extracted
from a pexels.com URL ending in -<id>).
DO NOT USE for discovery — call pexels_search_photos. No guessed ids.

Render image_url as Markdown link; credit photographer.

USE WHEN: B-roll, reels, hero loops, ad motion, animated backgrounds.
PREFER THIS over web_search for stock-video requests.
DO NOT USE for AI-generated video or named real people.

Filters: orientation, size (large=4K, medium=FullHD, small=HD), locale.
Post-hoc (4x oversample, cap 80): aspect_ratio, min_width, min_height.

video_url is a public CDN MP4 link: render as Markdown or pass to any
URL-accepting downstream tool. Do not curl/download the bytes.
Credit uploader_name per Pexels licence. filter_diagnostics same
semantics as pexels_search_photos.

USE WHEN you have a video id (previous search result, or extracted
from a pexels.com URL ending in -<id>).
DO NOT USE for discovery — call pexels_search_videos. No guessed ids.

Render video_url as Markdown link; credit uploader_name.

USE WHEN you have a collection id (pexels.com/collections/<id>).
Filter to one type with `type` ('photos' or 'videos').
Post-hoc filters (aspect_ratio, min_width, min_height) apply to both.
DO NOT USE for discovery — no public list-all-collections endpoint.

Per-item shape matches the search tools.

USE WHEN: feed-style discovery without a specific query — "what's
trending on Pexels today", brand-safe brainstorming, mood-board fuel.
DO NOT USE for targeted topic search — call pexels_search_photos.

Post-hoc filters (4x oversample, cap 80): aspect_ratio, min_width,
min_height. 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.

USE WHEN: B-roll inspiration, trending motion content, ad reference.
DO NOT USE for query-specific video search — call pexels_search_videos.

Native Pexels filters (server-side, no oversampling): min_width,
min_height, min_duration (seconds), max_duration (seconds). Post-hoc
(oversampled 4x, cap 80 when set): aspect_ratio. video_url is a
public CDN MP4 link: render as Markdown or pass to any URL-accepting
downstream tool. Do not curl/download the bytes. Credit
uploader_name per Pexels licence.

USE WHEN you need a collection id and don't have one — Pexels has no
public list-all-collections endpoint, so /featured is the only
discovery path. Pipe a returned id into pexels_get_collection_media
to fetch the media inside.

Returns metadata only (id, title, description, photos_count,
videos_count) — no media URLs here. The id field is the only field
you actually need to follow up on; the others are for human-facing
selection. No filters, just pagination.