Unsplash Recherche de photos API
Search Unsplash for free stock photos by keyword. Returns image URLs in several sizes, dimensions, alt text, the photographer's name and profile, and the photo's Unsplash page.
Tarifs
Tarifs de l’API Unsplash Recherche de photos
Essayer
Obtenez Unsplash Recherche de photos en une requête
{
"data": {
"photos": [
{
"alt": "example",
"blurHash": "a1b2c3d4",
"color": "#1f4fe0",
"createdUtc": 12.5,
"description": "A short example description of this item.",
"downloadUrl": "https://example.com/page",
"height": 42,
"id": "a1b2c3d4",
"image": "https://example.com/image.jpg",
"imageFull": "https://example.com/image.jpg",
"imageOriginal": "https://example.com/image.jpg",
"imageSmall": "https://example.com/image.jpg",
"likes": 12500,
"photographer": "https://example.com/image.jpg",
"photographerAvatarUrl": "https://example.com/image.jpg",
"photographerBio": "https://example.com/image.jpg",
"photographerForHire": true,
"photographerInstagramUsername": "https://example.com/image.jpg",
"photographerLocation": "https://example.com/image.jpg",
"photographerTotalLikes": 12500,
"photographerTotalPhotos": 12500,
"photographerTwitterUsername": "https://example.com/image.jpg",
"photographerUrl": "https://example.com/image.jpg",
"photographerUsername": "https://example.com/image.jpg",
"photographerWebsite": "https://example.com/image.jpg",
"sponsored": true,
"thumbnail": "https://example.com/image.jpg",
"updatedUtc": 12.5,
"url": "https://example.com/page",
"width": 1024
}
]
},
"found": true,
"reason": "not_found"
}Référence complète des paramètres et de la réponse : chaque champ, type et exemple de cet endpoint.
Référence
Une requête, une seule forme de réponse.
Chaque champ que vous envoyez et chaque champ que vous recevez, avec un vrai exemple.
Dernière vérification : 2026-10-07 · disponibilité et latence mesurées sur 30d
Corps de la requête
JSON, envoyé à cet endpoint.
- querystring
coffee
Keyword or phrase to search Unsplash photos for, e.g. "coffee" or "minimal workspace".
- colorenum
Only return photos with this dominant color tone. Omit for any color.
- limitinteger
2
Maximum number of photos to return (1-20, default 20). You are billed per photo returned, so a lower limit costs less.
- orientationenum
Only return photos with this orientation. Omit for any orientation.
- sortByenum
Order results by best match (relevant, the default) or newest first (recent).
Réponse
JSON, une valeur d’exemple par champ.
Free Unsplash photos matching the keyword. Unsplash+ premium photos are excluded, so every photo is under the Unsplash License. Unsplash places sponsored photos among the results, flagged by sponsored.
- altstring
Alt text describing the photo. Populated whenever the provider has data for the entity.
- blurHashstring
BlurHash string for rendering a blurred placeholder while the image loads.
- colorstring
Dominant color as a hex code, e.g. "#918c79".
- createdUtcnumber
UTC epoch timestamp in seconds (Unix time). Multiply by 1000 for a JS Date in milliseconds.
- descriptionstring
Photographer's own description. Absent when they wrote none.
- downloadUrlstring
Unsplash download link for the photo.
- heightinteger
Original height in pixels. Populated whenever the provider has data for the entity.
- idstring
Photo id on the source site. Populated whenever the provider has data for the entity.
- imagestring
Display-size image URL, 1080 px wide. The query parameters set the size, so keep the URL intact. Populated whenever the provider has data for the entity.
- imageFullstring
Full-resolution JPEG URL.
- imageOriginalstring
Original image URL at full resolution, unprocessed. Populated whenever the provider has data for the entity.
- imageSmallstring
Small image URL, 400 px wide.
- likesinteger
Number of likes on Unsplash.
- photographerstring
Photographer's display name, for attribution. Populated whenever the provider has data for the entity.
- photographerAvatarUrlstring
Photographer's profile picture URL.
- photographerBiostring
Photographer's Unsplash bio, when they wrote one.
- photographerForHireboolean
True when the photographer marks themselves available for hire on Unsplash.
- photographerInstagramUsernamestring
Photographer's Instagram username, when they list one on Unsplash.
- photographerLocationstring
Photographer's location as they state it on Unsplash, when they list one.
- photographerTotalLikesinteger
Number of photos the photographer has liked on Unsplash.
- photographerTotalPhotosinteger
Number of photos the photographer has published on Unsplash.
- photographerTwitterUsernamestring
Photographer's X (Twitter) username, when they list one on Unsplash.
- photographerUrlstring
Photographer's Unsplash profile page, for attribution. Populated whenever the provider has data for the entity.
- photographerUsernamestring
Photographer's Unsplash username, without the leading @.
- photographerWebsitestring
Photographer's portfolio or personal website, when they list one.
- sponsoredboolean
True when Unsplash placed this photo in the results as a sponsored listing.
- thumbnailstring
Thumbnail image URL, 200 px wide.
- updatedUtcnumber
When the photo's record last changed on Unsplash. UTC epoch timestamp in seconds (Unix time). Multiply by 1000 for a JS Date in milliseconds.
- urlstring
The photo's page on unsplash.com. Populated whenever the provider has data for the entity.
- widthinteger
Original width in pixels. Populated whenever the provider has data for the entity.
- foundboolean
- reason"not_found"
Present only when `found` is false, and says why there is no result. `not_found`: the source states the target does not exist, or returned nothing for it. A `found: false` answer is a successful call, not an error, and `costUsd` is what it actually cost.
FAQ
À propos de l’API Unsplash Recherche de photos
L’API Unsplash Recherche de photos d’AnyAPI renvoie des données Unsplash en JSON normalisé à partir d’un appel POST à /v1/run/unsplash.search_photos. Search Unsplash for free stock photos by keyword. Returns image URLs in several sizes, dimensions, alt text, the photographer's name and profile, and the photo's Unsplash page. AnyAPI renvoie un schéma normalisé unique quelle que soit la source qui répond. Elle coûte 1,60 $US pour 1 000 résultats, et jamais plus de 0,0336 $US pour une seule requête, en dollars US, sans abonnement et sans minimum mensuel. Ces 30 derniers jours, 100,0% des appels Unsplash Recherche de photos passés par AnyAPI ont réussi, avec un temps de réponse médian de 5,9 secondes, sur 9 appels mesurés.