Tools/stock-media

Stock Media

Active

Your agent can't source a real, licensed photo or video clip; this searches free, commercially usable images and footage from Pexels and Unsplash.

7 tools

Free, commercially usable stock media: search and fetch high-quality photos and video clips from Pexels and Unsplash, with photographer and source attribution. Attribution is required: credit the photographer and link back to Pexels or Unsplash. Unsplash additionally requires triggering its download endpoint when a photo is used (see the trigger_download tool).

Imagesphotosvideosfootagestock-imagesstock-videoimagespexelsunsplash

Tools (7)

▶pexels_video_search

Search Pexels for free stock video clips by keyword.

0.1 credits/call ($0.0001) · 0.1 credit per call

Example prompts

“Find free video clips of mountains”
“Search Pexels for vertical footage of the ocean”
“Get short landscape clips of coffee being poured”

Parameters

pageintegeroptionaldefault: 1

Result page.

sizestringoptional

Minimum clip size (large=4K, medium=Full HD, small=HD).

querystringrequired

Search keywords.

localestringoptional

Search locale (e.g. "en-US").

per_pageintegeroptionaldefault: 15

Results per page (1-80).

orientationstringoptional

Desired clip orientation.

max_durationintegeroptional

Maximum clip duration in seconds.

min_durationintegeroptional

Minimum clip duration in seconds.

API Usage

curl -X POST "https://skill.askfaro.com/skills/stock-media/run" \
  -H "Authorization: Bearer faro_<your_key>" \
  -H "Content-Type: application/json" \
  -d '{
  "intent": {
    "prompt": "Find free video clips of mountains"
  }
}'

CLI Usage

askfaro describe stock-media/pexels_video_search

Install pip install askfaro-cli, then askfaro auth login.

▶pexels_photo

Get a single Pexels photo by its ID.

0.1 credits/call ($0.0001) · 0.1 credit per call

Example prompts

“Get Pexels photo 2014422”
“Show the details and image URLs for this photo”
“What are the dimensions of this Pexels photo?”

Parameters

idintegerrequired

Pexels photo ID.

API Usage

curl -X POST "https://skill.askfaro.com/skills/stock-media/run" \
  -H "Authorization: Bearer faro_<your_key>" \
  -H "Content-Type: application/json" \
  -d '{
  "intent": {
    "prompt": "Get Pexels photo 2014422"
  }
}'

CLI Usage

askfaro describe stock-media/pexels_photo

Install pip install askfaro-cli, then askfaro auth login.

▶pexels_curated

Get a feed of curated, trending Pexels photos.

0.1 credits/call ($0.0001) · 0.1 credit per call

Example prompts

“Show me curated Pexels photos”
“Get the trending Pexels image feed”
“Browse top stock photos”

Parameters

pageintegeroptionaldefault: 1

Result page.

per_pageintegeroptionaldefault: 15

Results per page (1-80).

API Usage

curl -X POST "https://skill.askfaro.com/skills/stock-media/run" \
  -H "Authorization: Bearer faro_<your_key>" \
  -H "Content-Type: application/json" \
  -d '{
  "intent": {
    "prompt": "Show me curated Pexels photos"
  }
}'

CLI Usage

askfaro describe stock-media/pexels_curated

Install pip install askfaro-cli, then askfaro auth login.

▶unsplash_search

Search Unsplash for free stock photos by keyword.

0.1 credits/call ($0.0001) · 0.1 credit per call

Example prompts

“Find Unsplash photos of forests”
“Search Unsplash for portrait images of city streets”
“Get the latest Unsplash photos of food”

Parameters

langstringoptionaldefault: "en"

ISO 639-1 language for the query (beta).

pageintegeroptionaldefault: 1

Result page.

colorstringoptional

Desired color filter (e.g. "blue", "black_and_white").

querystringrequired

Search keywords.

order_bystringoptionaldefault: "relevant"

Result ordering.

per_pageintegeroptionaldefault: 10

Results per page (1-30).

orientationstringoptional

Desired photo orientation.

content_filterstringoptionaldefault: "low"

Content safety filter level.

API Usage

curl -X POST "https://skill.askfaro.com/skills/stock-media/run" \
  -H "Authorization: Bearer faro_<your_key>" \
  -H "Content-Type: application/json" \
  -d '{
  "intent": {
    "prompt": "Find Unsplash photos of forests"
  }
}'

CLI Usage

askfaro describe stock-media/unsplash_search

Install pip install askfaro-cli, then askfaro auth login.

▶unsplash_photo

Get a single Unsplash photo by its ID, with attribution and download links.

0.1 credits/call ($0.0001) · 0.1 credit per call

Example prompts

“Get Unsplash photo by its ID”
“Show details and image URLs for this Unsplash photo”
“What is the photographer and license info for this photo?”

Parameters

idstringrequired

Unsplash photo ID.

API Usage

curl -X POST "https://skill.askfaro.com/skills/stock-media/run" \
  -H "Authorization: Bearer faro_<your_key>" \
  -H "Content-Type: application/json" \
  -d '{
  "intent": {
    "prompt": "Get Unsplash photo by its ID"
  }
}'

CLI Usage

askfaro describe stock-media/unsplash_photo

Install pip install askfaro-cli, then askfaro auth login.

▶unsplash_trigger_download

0.1 credits/call ($0.0001) · 0.1 credit per call

Example prompts

“Trigger the Unsplash download for this photo I'm using”
“Register a download for this Unsplash image”
“Get the download URL and credit the photographer”

Parameters

idstringrequired

Unsplash photo ID being used.

API Usage

curl -X POST "https://skill.askfaro.com/skills/stock-media/run" \
  -H "Authorization: Bearer faro_<your_key>" \
  -H "Content-Type: application/json" \
  -d '{
  "intent": {
    "prompt": "Trigger the Unsplash download for this photo I'm using"
  }
}'

CLI Usage

askfaro describe stock-media/unsplash_trigger_download

Install pip install askfaro-cli, then askfaro auth login.

▶pexels_search

Search Pexels for free stock photos by keyword.

0.1 credits/call ($0.0001) · 0.1 credit per call

Example prompts

“Find free photos of mountains”
“Search Pexels for landscape images of the ocean”
“Get vertical photos of coffee”

Parameters

pageintegeroptionaldefault: 1

Result page.

sizestringoptional

Minimum photo size.

colorstringoptional

Desired color (named, e.g. "red", or hex like "ff0000").

querystringrequired

Search keywords.

localestringoptional

Search locale (e.g. "en-US").

per_pageintegeroptionaldefault: 15

Results per page (1-80).

orientationstringoptional

Desired photo orientation.

API Usage

curl -X POST "https://skill.askfaro.com/skills/stock-media/run" \
  -H "Authorization: Bearer faro_<your_key>" \
  -H "Content-Type: application/json" \
  -d '{
  "intent": {
    "prompt": "Find free photos of mountains"
  }
}'

CLI Usage

askfaro describe stock-media/pexels_search

Install pip install askfaro-cli, then askfaro auth login.