Skip to main content
Server path: /pexels | Type: Application | PCID required: Yes

Tools

ToolDescription
pexels_get_collection_mediaGet media in a collection
pexels_get_curated_photosGet curated photos
pexels_get_featured_collectionsGet featured collections
pexels_get_my_collectionsGet the authenticated user’s collections
pexels_get_photoGet a photo by ID
pexels_get_popular_videosGet popular videos
pexels_get_videoGet a video by ID
pexels_search_photosSearch photos
pexels_search_videosSearch videos

pexels_get_collection_media

Get media in a collection Parameters:
ParameterTypeRequiredDefaultDescription
idstringYesThe Pexels collection ID.
typestringNoFilter the media type returned in the collection.
sortstringNoSort order for the media in the collection.
pageintegerNoThe page number to return. Defaults to 1.
per_pageintegerNoThe number of results per page. Defaults to 15, maximum 80.

pexels_get_curated_photos

Get curated photos Parameters:
ParameterTypeRequiredDefaultDescription
pageintegerNoThe page number to return. Defaults to 1.
per_pageintegerNoThe number of results per page. Defaults to 15, maximum 80.

Get featured collections Parameters:
ParameterTypeRequiredDefaultDescription
pageintegerNoThe page number to return. Defaults to 1.
per_pageintegerNoThe number of results per page. Defaults to 15, maximum 80.

pexels_get_my_collections

Get the authenticated user’s collections Parameters:
ParameterTypeRequiredDefaultDescription
pageintegerNoThe page number to return. Defaults to 1.
per_pageintegerNoThe number of results per page. Defaults to 15, maximum 80.

pexels_get_photo

Get a photo by ID Parameters:
ParameterTypeRequiredDefaultDescription
idintegerYesThe Pexels photo ID.

Get popular videos Parameters:
ParameterTypeRequiredDefaultDescription
min_widthintegerNoThe minimum width in pixels of the returned videos.
min_heightintegerNoThe minimum height in pixels of the returned videos.
min_durationintegerNoThe minimum duration in seconds of the returned videos.
max_durationintegerNoThe maximum duration in seconds of the returned videos.
pageintegerNoThe page number to return. Defaults to 1.
per_pageintegerNoThe number of results per page. Defaults to 15, maximum 80.

pexels_get_video

Get a video by ID Parameters:
ParameterTypeRequiredDefaultDescription
idintegerYesThe Pexels video ID.

pexels_search_photos

Search photos Parameters:
ParameterTypeRequiredDefaultDescription
querystringYesThe search query (e.g. “Ocean”, “Tigers”, “Pears”).
orientationstringNoDesired photo orientation.
sizestringNoMinimum photo size.
colorstringNoDesired photo color. Supports common color names (red, orange, yellow, green, turquoise, blue, violet, pink, brown, black, gray, white) or any hex color (e.g. “#ffa500”).
localestringNoLocale of the search query (e.g. “en-US”, “pt-BR”, “es-ES”, “ja-JP”).
pageintegerNoThe page number to return. Defaults to 1.
per_pageintegerNoThe number of results per page. Defaults to 15, maximum 80.

pexels_search_videos

Search videos Parameters:
ParameterTypeRequiredDefaultDescription
querystringYesThe search query (e.g. “Ocean”, “Tigers”, “Pears”).
orientationstringNoDesired video orientation.
sizestringNoMinimum video size.
localestringNoLocale of the search query (e.g. “en-US”, “pt-BR”, “es-ES”, “ja-JP”).
pageintegerNoThe page number to return. Defaults to 1.
per_pageintegerNoThe number of results per page. Defaults to 15, maximum 80.