Skills/Images/Find a stock photo

Find a stock photo

0.1 credits / search

Searches free, commercially usable stock-photo libraries for real photographs that match your description and returns a set of candidates, each with image URLs, dimensions, and the photographer credit needed for attribution. Describe the subject you want, and optionally ask for a square, portrait, or landscape orientation. Nothing is generated, these are real photos by real photographers.

Use when

You want an authentic photo of a real, findable subject rather than a generated one.

Not for

Bespoke, branded, or non-existent scenes that no real photo would show.

Cost

0.1 credits / search

What it accepts

Set these inside the intent when you run it.

descriptionrequired

What to search for, in plain words.

aspect_ratiooptional

Optional shape, one of square, portrait, or landscape.

What you get back

A set of candidate photos, each with image URLs, dimensions, and photographer and source attribution.

Run it

Run this sub-skill directly: pin it with operation and pass its inputs in the intent. (Omit operation and the Images skill will route from your intent instead.)

curl -X POST "https://skill.askfaro.com/skills/image/run" \
  -H "Authorization: Bearer $FARO_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"intent":{"operation":"find","description":"snowy mountains at sunrise","aspect_ratio":"landscape"}}'

Example requests

  • Get me a photo of the Rocky Mountains
  • Find a landscape shot of the ocean at sunset
  • I need a vertical photo of someone drinking coffee