API de Unsplash

API de Unsplash: Buscar fotos

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.

POST/v1/run/unsplash.search_photos
Disponibilidad
88.54%
30d · 323 llamadas
Solicitudes
323
30d · semanal, últimas 12 sem.
Respuesta
13.8s
mediana · 30d

Precios

Precios del endpoint Buscar fotos de la API de Unsplash

Pagas
US$16.00
US$1.60/1k resultados, solo por lo que usas. Sin plan mensual.
Una solicitud cuesta como máximo US$0.0336 (21 results).
El saldo inicial de US$0.10 alcanza para al menos 2 solicitudes.

Pruébalo

Obtén Buscar fotos de Unsplash en una sola solicitud

Abrir en
Respuesta de ejemplo
Las ejecuciones gratis devuelven solo los primeros 3 resultados. Agrega fondos a una clave para obtener la respuesta completa.
{
  "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"
}

Referencia completa de parámetros y respuesta: cada campo, tipo y ejemplo de este endpoint.

Referencia

Una solicitud, un formato de respuesta.

Cada campo que envías y cada campo que recibes, cada uno con un ejemplo real.

Verificado por última vez el 2026-11-20 · disponibilidad y latencia medidas en 30d

Cuerpo de la solicitud

JSON, enviado por POST a este 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).

Envías. Un cuerpo JSON pequeño. Los valores que se muestran son ejemplos para reemplazar por los tuyos.

Respuesta

JSON, un valor de ejemplo por campo.

each photodata.photos[]

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.

top level
  • 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.

Recibes. Campos con nombre y tipo, con el mismo formato sin importar qué fuente responda.

Preguntas frecuentes

Acerca del endpoint Buscar fotos de la API de Unsplash

El endpoint Buscar fotos de AnyAPI para Unsplash devuelve datos de Unsplash como JSON normalizado con una sola llamada POST a /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 devuelve un único esquema normalizado sin importar qué fuente atienda la solicitud. Cuesta US$1.60 por cada 1,000 resultados, y nunca más de US$0.0336 por una sola solicitud, en dólares estadounidenses, sin suscripción y sin mínimo mensual. En los últimos 30 días, el 88.5% de las llamadas al endpoint Buscar fotos de la API de Unsplash a través de AnyAPI tuvo éxito, con un tiempo de respuesta mediano de 13.8 segundos en 323 llamadas medidas.

Cuesta US$1.60 por cada 1,000 resultados, y nunca más de US$0.0336 por una sola solicitud, en dólares estadounidenses, sin suscripción y sin mínimo mensual. Agregas fondos a una billetera en dólares y cada llamada descuenta de ella. Algunas solicitudes fallidas pagadas con la billetera generan cargos de procesamiento que trasladamos al costo, sin margen; la respuesta de error muestra el monto cobrado.

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. La respuesta es JSON normalizado con el mismo envoltorio que devuelve cada endpoint de AnyAPI, así que procesar un segundo endpoint es solo cambiar la URL.

En los últimos 30 días, el 88.5% de las llamadas al endpoint Buscar fotos de la API de Unsplash a través de AnyAPI tuvo éxito, con un tiempo de respuesta mediano de 13.8 segundos en 323 llamadas medidas. Estas son mediciones propias de AnyAPI sobre el tráfico que pasa por el gateway, recalculadas continuamente, no un objetivo de nivel de servicio publicado.

Sí. Una cuenta nueva de AnyAPI empieza con US$0.10 de saldo gratis, sin tarjeta, que alcanza para al menos 2 llamadas a Buscar fotos de Unsplash a un máximo de US$0.0336 cada una.

Envía una solicitud POST a https://api.getanyapi.com/v1/run/unsplash.search_photos con tu clave de AnyAPI en un encabezado "Authorization: Bearer" y la entrada como cuerpo JSON. La misma clave y la misma billetera sirven para todos los endpoints de AnyAPI.

No. Agregas dólares a un solo saldo prepagado de AnyAPI y cada solicitud descuenta de él. No hay plan mensual ni mínimo, y el mismo saldo paga todos los endpoints de AnyAPI.

Sí. Instala @getanyapi/sdk desde npm para TypeScript o getanyapi desde pip para Python. Ambos llaman a todos los endpoints de AnyAPI con la misma clave, y también sirve cualquier cliente HTTP.

Sí. Un agente puede conectarse al servidor MCP de AnyAPI en https://api.getanyapi.com/mcp, o crear su propia clave de prueba gratis con un solo POST sin autenticar a https://api.getanyapi.com/agent/signup y llamar a este endpoint por HTTP.