Búsqueda web

Última actualización July 20, 2026

Resultados de búsqueda web agregados en formato JSON.

TEXT

GET /v1/search

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. Admite los operadores de búsqueda de Suede (p. ej. `site:`, `filetype:`, `"frase exacta"`, `-excluir`).
`safe`	string	no	`on`	Nivel de búsqueda segura: `off` o `on`. Un valor no reconocido se trata como `on`.
`gl`	string	no	(auto)	Código de región/país de dos letras para la ponderación de resultados (p. ej. `us`, `gb`, `ca`, `de`, `jp`). Un código no admitido se ignora (se aplica el predeterminado del proveedor).
`hl`	string	no	(auto)	Código de idioma de dos letras para los resultados (p. ej. `en`, `es`, `fr`, `de`, `ja`). Un código no admitido se ignora.
`time`	string	no	`any`	Filtro de recencia: `any`, `hour`, `day`, `week`, `month` o `year`.
`num`	integer	no	(predeterminado del proveedor)	Número de resultados deseado. Se acota a 5–100; un valor fuera de rango vuelve a 20. Omítelo para usar el predeterminado del proveedor.

Respuesta

JSON

{
  "query": "hello world",
  "results": [
    {
      "title": "Example Domain",
      "url": "https://example.com/",
      "description": "This domain is for use in illustrative examples in documents."
    }
  ]
}

Campo	Tipo	Descripción
`query`	string	La consulta que se ejecutó.
`results`	array	Los resultados web.
`results[].title`	string	Título del resultado.
`results[].url`	string	URL del resultado.
`results[].description`	string	Fragmento / descripción del resultado.

Ejemplos

cURL

curl -G "https://api.suede.io/v1/search" \
  -H "Authorization: Bearer $SUEDE_API_KEY" \
  --data-urlencode "q=site:example.com filetype:pdf annual report" \
  --data-urlencode "gl=us" \
  --data-urlencode "num=20"

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

JavaScript

const params = new URLSearchParams({ q: "hello world", gl: "us", num: "20" });
const res = await fetch(`https://api.suede.io/v1/search?${params}`, {
  headers: { Authorization: `Bearer ${process.env.SUEDE_API_KEY}` },
});
const data = await res.json();
for (const r of data.results) console.log(r.title, r.url);

Facturación

Cada llamada descuenta de tu crédito de API prepagado. Un recuento de resultados elevado (num por encima de 10) puede desplegarse en varias obtenciones de página upstream y se factura en consecuencia. Consulta tu saldo en cualquier momento mediante Uso.