Unsplash
Banco de fotografía libre con búsqueda, colecciones y descarga por API.
Ver la documentaciónPara qué sirve
Qué problema resuelve
La API de Unsplash busca fotos para productos digitales y devuelve resultados, colecciones y URLs preparadas para hotlinking. El modo Demo permite 50 solicitudes por hora y Production 1.000 por hora si la aplicación cumple las directrices. Exige atribución y hotlinking.
En la práctica
Qué puedes hacer con ella
- Buscar fotos por palabra clave.
- Obtener una foto aleatoria con filtros.
- Listar colecciones curadas.
- Hotlinkear imágenes con los parámetros de tamaño de Unsplash.
- Disparar el endpoint de download para estadísticas cuando el usuario descarga.
¿Es gratis?
Demo 50/h · Production 1.000/h
API gratuita tras registrar una aplicación. Demo permite 50 solicitudes por hora y Production 1.000 por hora. Las cabeceras X-Ratelimit-* informan del consumo. Debes cumplir las directrices de atribución y hotlinking.
Comprobado el 2026-08-02. Fuente: página oficial de precios o límites
Registrar app en Unsplash Developers
Qué cuenta como una «llamada» aquí
Cada request a api.unsplash.com (search, photos, collections…) cuenta 1 contra tu cupo horario.
Servir la imagen desde las URLs de Unsplash (hotlink) no es lo mismo que una llamada API; no copies el fichero a tu CDN.
Rate limiting
| Límite | Cuota | Qué significa en la práctica |
|---|---|---|
| Demo | 50 requests / hora | Suficiente para desarrollo y pruebas. |
| Production | 1.000 requests / hora | Tras aplicar y cumplir guidelines. |
| Cabeceras | X-Ratelimit-Remaining | Mira cuánto te queda en cada respuesta. |
Precios
| Plan | Precio | Para quién | Qué incluye (resumen) |
|---|---|---|---|
| API Demo / Production | $0 | Productos que cumplen guidelines Unsplash. | Search · photos · hotlinking · atribución. |
Uso permitido, comercial y licencia
| Pregunta | Respuesta clara |
|---|---|
| ¿Licencia de fotos? | Fotos Unsplash License (uso libre con reglas); atribuye al fotógrafo y hotlinkea. |
| ¿Uso comercial? | Generalmente sí bajo la Unsplash License y las API Guidelines; no vendas las fotos como tal ni faltes a atribución. |
| ¿Hace falta cuenta? | Sí: Access Key de una aplicación registrada. |
Cómo empezar
Buscar fotos de Barcelona con tu Access Key.
Registra una app y copia el Access Key.
Dirección base de las imágenes: https://api.unsplash.com
- 01
Paso 1
Crea la app en https://unsplash.com/oauth/applications
- 02
Paso 2
GET https://api.unsplash.com/search/photos?query=barcelona con Authorization: Client-ID TU_KEY
- 03
Paso 3
Hotlinkea urls.raw/regular de los resultados; no rehostees.
- 04
Paso 4
Atribuye al usuario (photographer) según guidelines.
- 05
Paso 5
Controla X-Ratelimit-Remaining (Demo 50/h).
Con tu agente
Prompt para integrar la API
Prompt para que tu agente lo deje listo
Pega esto en Cursor, Claude Code, Codex u otro agente de código:
Integra Unsplash API. Docs: https://unsplash.com/documentation . Demo permite 50 solicitudes/hora y Production 1.000/hora. Mantén hotlinking y atribución obligatorios y no inventes Access Keys. ¿Necesitas búsqueda o una foto aleatoria?Detalle técnico
Acceso, HTTPS y CORS
- 01
Acceso · OAuth
Requiere flujo OAuth: el usuario autoriza tu aplicación antes de leer sus datos.
- 02
HTTPS · Sí
Sirve sobre TLS, así que vale para producción y para páginas ya en HTTPS.
- 03
CORS · Sin verificar
No consta si permite llamadas desde el navegador; pruébalo antes de montar el cliente.