Unsplash
Photo search results, photographer details and photo links
Discover photos shared on Unsplash.
Your information
What the photos should show, for example team meeting.
More options
Page of results for the requested count, for example 1.
Maximum photos per returned page, for example 20.
Photo shape to show, for example landscape.
Include paid Unsplash+ photos, for example false.
Example results
Photo search results
About the Unsplash tool
Unsplash Photos searches photos by a required phrase, with optional page, result count, orientation, and Unsplash+ inclusion.
Search photos returns images with dimensions, likes, descriptions, licence notes, photo links, and photographer details.
Built from unsplash.com. Last checked Sep 29, 2026.
Actions
Search photos
1 creditFind Unsplash photos matching a search phrase, in search order. Excludes Unsplash+ photos unless included; each result has image, photographer, licence and photo links. The site returns up to 20 photos per search page, so larger requests span multiple pages.
What you provide
| Field | Type | Required | Description |
|---|---|---|---|
Pagepage | Number | Optional | Page of results for the requested count, for example 1.Example: 2 |
Queryquery | Text | Required | What the photos should show, for example team meeting.Example: team meeting |
Max Resultsmax_results | Number | Optional | Maximum photos per returned page, for example 20.Example: 25 |
Orientationorientation | Text | Optional | Photo shape to show, for example landscape.Example: Square |
Include Unsplash Plusinclude_unsplash_plus | Yes or no | Optional | Include paid Unsplash+ photos, for example false.Example: Yes |
What you get
| Field | Type | Description |
|---|---|---|
Photosphotos | List | |
Likesphotos[].likes | Number | Number of likes.Example: 6558 |
Widthphotos[].width | Number | Image width in pixels.Example: 5472 |
Heightphotos[].height | Number | Image height in pixels.Example: 3648 |
Photo IDphotos[].photo_id | Text | Unsplash photo ID.Example: KdeqA3aTnBY |
Blur Hashphotos[].blur_hash | Text | Blur hash for a preview.Example: LLH2K8Dh0L%h-:XUem%2E2r;xFW= |
Descriptionphotos[].description | Text | Photo description, or null if not available.Example: Teamwork makes the dream work. |
Licence Notephotos[].licence_note | Text | Licence requirement for this photo.Example: Free to use under the Unsplash License |
Photo Page Linkphotos[].photo_page_link | Text | Photo page on Unsplash.Example: https://unsplash.com/photos/people-sitting-on-chair-in-front-of-table-while-hol… |
Is Unsplash Plusphotos[].is_unsplash_plus | Yes or no | Whether the image requires an Unsplash+ licence.Example: No |
Photographer Namephotos[].photographer_name | Text | Photographer name.Example: Dylan Gillis |
Regular Image Linkphotos[].regular_image_link | Text | Image around 1080 pixels wide.Example: https://images.unsplash.com/photo-1517048676732-d65bc937f952?crop=entropy&cs=ti… |
Full Size Image Linkphotos[].full_size_image_link | Text | Full-size image.Example: https://images.unsplash.com/photo-1517048676732-d65bc937f952?crop=entropy&cs=sr… |
Photographer Profile Linkphotos[].photographer_profile_link | Text | Photographer profile page.Example: https://unsplash.com/@mainermedia |
Example result
For Query: team meeting
{
"photos": [
{
"likes": 6558,
"width": 5472,
"height": 3648,
"photo_id": "KdeqA3aTnBY",
"blur_hash": "LLH2K8Dh0L%h-:XUem%2E2r;xFW=",
"description": "Teamwork makes the dream work.",
"licence_note": "Free to use under the Unsplash License",
"photo_page_link": "https://unsplash.com/photos/people-sitting-on-chair-in-front-of-table-while-holding-pens-during-daytime-KdeqA3aTnBY",
"is_unsplash_plus": false,
"photographer_name": "Dylan Gillis",
"regular_image_link": "https://images.unsplash.com/photo-1517048676732-d65bc937f952?crop=entropy&cs=tinysrgb&fit=max&fm=jpg&ixid=M3wxMjA3fDB8MXxzZWFyY2h8MXx8dGVhbSUyMG1lZXRpbmd8ZW58MHx8fHwxNzkwNjQzMzQ3fDI&ixlib=rb-4.1.0&q=8…",
"full_size_image_link": "https://images.unsplash.com/photo-1517048676732-d65bc937f952?crop=entropy&cs=srgb&fm=jpg&ixid=M3wxMjA3fDB8MXxzZWFyY2h8MXx8dGVhbSUyMG1lZXRpbmd8ZW58MHx8fHwxNzkwNjQzMzQ3fDI&ixlib=rb-4.1.0&q=85",
"photographer_profile_link": "https://unsplash.com/@mainermedia"
}
]
}For developers
Call it from your code with one request. Change the values in input to run it on new data. To get an API key, open Developers at the bottom of Studio, turn on Developer mode and go to API keys.
curl 'https://api.fous.com/v1/query' \
--fail-with-body --silent --show-error --max-time 180 \
-H "Authorization: Bearer YOUR_API_KEY" \
-H 'Content-Type: application/json' \
--data-raw '{
"api": "@unsplash",
"visibility": "public",
"operation": "search_photos",
"version": 1,
"input": {
"query": "team meeting"
},
"response": {
"format": "json"
}
}'What you can do with it
- Find photos for a presentation by topic and orientation
- Review photographer names and licence notes before selecting images
- Compare photo dimensions and likes across search results
- Collect photo and photographer links for editorial research
Questions about Unsplash
Can I run it with my own inputs?
Yes. Change the inputs in Studio and press Run, or send new inputs from your code, or ask a connected AI assistant.
Can I call this Unsplash tool as an API?
Yes. Send a POST request to /v1/query with your Fous API key and the inputs, and get JSON back.
How much does it cost?
Each completed run costs 1 credit. Failed runs without a completed receipt are free; completed work can remain charged if delivery is interrupted. With pay as you go, a credit costs 1¢. Monthly plans cost less per credit.
Do I need a Unsplash account?
No. You only need a Fous account.
How current is the data?
Fous gets the data from unsplash.com when you run it. Some results are reused for up to 24 hours, and results that use your account or key are never reused. It was last verified on Sep 29, 2026.
What photos match a particular search phrase?
Search photos returns matching photos in search order for the required search phrase.
Who took a photo?
Search photos returns the photographer's name and profile link with each result.
What licence applies to a photo?
Search photos returns a licence note and indicates whether a photo requires an Unsplash+ licence.