Unsplash API
Des millions de photos haute qualité, accessibles gratuitement par API.
L'Unsplash API donne accès par requêtes REST à l'immense photothèque d'Unsplash, composée de photos et d'illustrations de haute qualité publiées par une large communauté de photographes. Elle permet de rechercher des images, de récupérer leurs métadonnées et de les redimensionner dynamiquement via des paramètres d'URL. Elle s'adresse aux développeurs qui veulent intégrer un catalogue de visuels libres dans une application, un site ou un outil de création.
Que propose l'API Unsplash ?
Tarifs de l'API Unsplash
Gratuit pour les usages standards via un palier Demo, puis un palier Production gratuit après validation de l'application. Une offre Enterprise payante (sur devis) donne accès à un volume illimité et aux images Unsplash+.
Offre gratuite — Palier Demo gratuit limité à 50 requêtes par heure, suffisant pour développer et tester. Après revue et approbation de l'application, le palier Production gratuit débloque jusqu'à 5 000 requêtes par heure. Aucune carte bancaire requise.
Authentification & intégration
Clé d'accès (Access Key) liée à l'application enregistrée, transmise dans l'en-tête Authorization (Client-ID). Une authentification OAuth est disponible pour les actions effectuées au nom d'un utilisateur (liker une photo, ajouter à une collection).
API REST renvoyant du JSON. On crée une application sur le portail développeurs pour obtenir une Access Key et une Secret Key. La conformité aux conditions d'utilisation est obligatoire : attribuer le photographe et Unsplash avec un lien, ne pas reproduire l'expérience d'Unsplash, et déclencher l'endpoint download_location à chaque téléchargement effectif d'une image (pour comptabiliser les statistiques de l'auteur).
Cas d'usage de l'API Unsplash
- Ajouter un sélecteur d'images libres dans un éditeur de site, un CMS ou un outil de design.
- Illustrer automatiquement des articles ou des fiches avec des photos pertinentes par mot-clé.
- Générer des images de couverture redimensionnées à la volée via les paramètres d'URL.
- Alimenter un fond d'écran ou un arrière-plan dynamique dans une application.
- Construire une galerie thématique à partir des collections et topics d'Unsplash.
- Récupérer des métadonnées riches (EXIF, localisation, auteur) pour enrichir un catalogue visuel.
✓ Points forts
- Photothèque vaste et de très haute qualité, gratuite pour la plupart des usages.
- Redimensionnement et recadrage dynamiques des images directement via l'URL.
- Métadonnées riches : EXIF, localisation, statistiques, informations sur l'auteur.
- Bibliothèques officielles (JavaScript, PHP, Ruby) et nombreuses bibliothèques communautaires.
- Palier Production gratuit généreux (5 000 requêtes/heure) après approbation.
⚠ Limites
- Conditions d'utilisation strictes : attribution obligatoire et appel de l'endpoint de téléchargement à respecter.
- Le palier Demo est plafonné à 50 requêtes/heure tant que l'application n'est pas approuvée.
- Le passage en Production exige une revue manuelle de l'application par Unsplash.
- Les images premium (Unsplash+) ne sont accessibles que via l'offre Enterprise payante.
Questions fréquentes sur l'API Unsplash
L'Unsplash API est-elle gratuite ?
Oui pour les usages standards. Le palier Demo gratuit autorise 50 requêtes par heure pour développer, et après approbation de l'application le palier Production gratuit monte à 5 000 requêtes par heure. Seule l'offre Enterprise (volume illimité, images Unsplash+) est payante.
Quelle authentification utilise l'API ?
Une Access Key liée à votre application, passée dans l'en-tête Authorization au format Client-ID. Pour agir au nom d'un utilisateur (liker, ajouter à une collection), une authentification OAuth est nécessaire.
Dois-je créditer les photographes ?
Oui, l'attribution est obligatoire : il faut citer le photographe et Unsplash avec un lien vers la photo et le profil. C'est une condition d'utilisation à respecter pour conserver l'accès à l'API.
Qu'est-ce que l'endpoint download_location ?
C'est un endpoint qu'il faut déclencher à chaque téléchargement réel d'une image afin de comptabiliser correctement les statistiques de l'auteur. Son appel est exigé par les conditions d'utilisation de l'API.
Comment passer du palier Demo au palier Production ?
Il faut soumettre votre application à la revue d'Unsplash. Une fois approuvée, la limite passe de 50 à 5 000 requêtes par heure, sans frais supplémentaires.
Puis-je redimensionner les images sans les télécharger ?
Oui. Les URLs d'images d'Unsplash acceptent des paramètres (largeur, hauteur, recadrage, qualité, format) qui appliquent un redimensionnement dynamique côté serveur, sans manipulation locale.
