Búsqueda de imágenes

Última actualización July 20, 2026

Resultados de búsqueda de imágenes en formato JSON.

TEXT

GET /v1/images

Requiere una clave de API válida, una membresía activa y crédito de API disponible.

Parámetros de consulta

Nombre	Tipo	Obligatorio	Predeterminado	Descripción
`q`	string	sí	—	La consulta de búsqueda.
`safe`	string	no	`on`	Nivel de búsqueda segura: `off` o `on`.
`gl`	string	no	(auto)	Código de región/país de dos letras (p. ej. `us`, `gb`, `jp`).
`hl`	string	no	(auto)	Código de idioma de dos letras (p. ej. `en`, `es`, `ja`).
`time`	string	no	`any`	Filtro de recencia: `any`, `hour`, `day`, `week`, `month`, `year`.
`num`	integer	no	(predeterminado del proveedor)	Recuento de resultados deseado. Se acota a 5–100 (fuera de rango → 20).

Respuesta

Los endpoints verticales comparten una misma forma de resultado; solo se rellenan los campos relevantes para la vertical. Para las imágenes, thumbnail y meta (fuente) son los más útiles; price y extra suelen ser nulos.

JSON

{
  "query": "golden gate bridge",
  "kind": "image",
  "results": [
    {
      "title": "Golden Gate Bridge at sunset",
      "url": "https://example.com/photos/ggb.jpg",
      "description": null,
      "thumbnail": "https://example.com/photos/ggb-thumb.jpg",
      "price": null,
      "meta": "example.com",
      "extra": null
    }
  ]
}

Campo	Tipo	Descripción
`query`	string	La consulta que se ejecutó.
`kind`	string	Siempre `image` para este endpoint.
`results[].title`	string	Título / pie de la imagen.
`results[].url`	string	URL de la imagen completa (o de su página).
`results[].description`	string \| null	Descripción, cuando está disponible.
`results[].thumbnail`	string \| null	URL de la imagen en miniatura.
`results[].meta`	string \| null	Fuente / host.
`results[].price`	string \| null	No se usa para imágenes.
`results[].extra`	string \| null	No se usa para imágenes.

Ejemplos

cURL

curl -G "https://api.suede.io/v1/images" \
  -H "Authorization: Bearer $SUEDE_API_KEY" \
  --data-urlencode "q=golden gate bridge" \
  --data-urlencode "safe=on"

using var http = new HttpClient();
http.DefaultRequestHeaders.Authorization =
    new("Bearer", Environment.GetEnvironmentVariable("SUEDE_API_KEY"));
var url = "https://api.suede.io/v1/images?q=" + Uri.EscapeDataString("golden gate bridge");
Console.WriteLine(await http.GetStringAsync(url));

JavaScript

const res = await fetch(
  "https://api.suede.io/v1/images?q=" + encodeURIComponent("golden gate bridge"),
  { headers: { Authorization: `Bearer ${process.env.SUEDE_API_KEY}` } },
);
const data = await res.json();
for (const r of data.results) console.log(r.thumbnail);