Visión general de la API

La API de búsqueda de Suede devuelve resultados de búsqueda privados y sin anuncios en formato JSON: los mismos resultados web, de imágenes, de noticias, de vídeo y de compras que dan vida a Suede, sin publicidad ni rastreo, y sin conservar un historial de consultas asociado a ti.

URL base

Un único endpoint global sirve a todas las cuentas:

https://api.suede.io

Las peticiones se enrutan automáticamente a la región de infraestructura más cercana: todas las regiones sirven la misma API, y el parámetro opcional gl elige la ponderación de resultados por consulta. No hay nada que configurar.

El explorador interactivo

El host de la API sirve una referencia en vivo, en el navegador. Abre la raíz del host (https://api.suede.io/) y redirige al explorador en /scalar/v1, donde cada endpoint está documentado y se puede invocar con tu propia clave. La descripción OpenAPI legible por máquina está en /openapi/v1.json si quieres generar un cliente o importar la API en otra herramienta.

Autenticación

Cada petición debe llevar tu clave de API como token bearer:

Authorization: Bearer suede_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Crea una clave en tu cuenta de Suede; consulta Autenticación. Los endpoints de búsqueda facturables requieren una membresía de Suede activa y un saldo de crédito de API positivo.

Una primera petición

curl "https://api.suede.io/v1/search?q=hello+world" \
  -H "Authorization: Bearer $SUEDE_API_KEY"

using var http = new HttpClient();
http.DefaultRequestHeaders.Authorization =
    new("Bearer", Environment.GetEnvironmentVariable("SUEDE_API_KEY"));
var json = await http.GetStringAsync("https://api.suede.io/v1/search?q=hello+world");
Console.WriteLine(json);

const res = await fetch("https://api.suede.io/v1/search?q=hello+world", {
  headers: { Authorization: `Bearer ${process.env.SUEDE_API_KEY}` },
});
console.log(await res.json());

Respuestas

Una respuesta correcta es JSON con HTTP 200. Un error usa un envoltorio uniforme:

{ "error": { "type": "invalid_request", "message": "Query parameter 'q' is required.", "request_id": "a1b2c3d4e5f6a7b8" } }

Cada respuesta lleva una cabecera X-Request-Id (reflejada como request_id en los errores); cítala al ponerte en contacto con soporte. Errores enumera el conjunto completo de tipos y códigos de estado, y Límites de frecuencia describe la limitación.

Versionado

La versión actual es la v1, accesible bajo el prefijo de ruta /v1. Pueden añadirse campos nuevos a las respuestas sin cambiar de versión, así que analiza de forma defensiva e ignora los campos desconocidos. Un cambio incompatible se publicaría bajo un nuevo prefijo de versión.

Endpoints de un vistazo