stock-media/unsplash_search

Search Unsplash for free stock photos by keyword.

0.1 credits / call ($0.0001)

charged on success

What it does

Searches Unsplash and returns matching photos with their IDs, dimensions, colors, photographer details, image URLs, and the links needed for attribution and download tracking.

Primary use cases

Finding free, high-quality images for a topic.
Sourcing images by orientation or color.

Why use this tool

Unsplash has specific, mandatory usage rules. Honor them when you use an image:

Credit the photographer and Unsplash with hotlinks. The photographer name is user.name, their profile is user.links.html, and the photo page is links.html. Append ?utm_source=faro&utm_medium=referral to those links, e.g. "Photo by {user.name} on Unsplash".
When a photo is actually used (downloaded, inserted, set as a background), call unsplash_trigger_download for that photo. This registers the use for the photographer and is required by the Unsplash API guidelines.

Good to know

Embed/display images via the urls.* hotlinks; never hotlink the download endpoint. Use orientation (landscape, portrait, squarish) and order_by (relevant, latest).

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.