Recherche web

Dernière mise à jour July 20, 2026

Résultats de recherche web agrégés au format JSON.

TEXT

GET /v1/search

Requiert une clé d'API valide, un abonnement actif et du crédit d'API disponible.

Paramètres de requête

Nom	Type	Obligatoire	Par défaut	Description
`q`	string	oui	—	La requête de recherche. Prend en charge les opérateurs de recherche de Suede (p. ex. `site:`, `filetype:`, `"phrase exacte"`, `-exclure`).
`safe`	string	non	`on`	Niveau de recherche sécurisée : `off` ou `on`. Une valeur non reconnue est traitée comme `on`.
`gl`	string	non	(auto)	Code de région/pays à deux lettres pour la pondération des résultats (p. ex. `us`, `gb`, `ca`, `de`, `jp`). Un code non pris en charge est ignoré (le défaut du fournisseur s'applique).
`hl`	string	non	(auto)	Code de langue à deux lettres pour les résultats (p. ex. `en`, `es`, `fr`, `de`, `ja`). Un code non pris en charge est ignoré.
`time`	string	non	`any`	Filtre de récence : `any`, `hour`, `day`, `week`, `month` ou `year`.
`num`	integer	non	(défaut du fournisseur)	Nombre de résultats souhaité. Borné à 5–100 ; une valeur hors plage revient à 20. Omettez-le pour utiliser le défaut du fournisseur.

Réponse

JSON

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

Champ	Type	Description
`query`	string	La requête qui a été exécutée.
`results`	array	Les résultats web.
`results[].title`	string	Titre du résultat.
`results[].url`	string	URL du résultat.
`results[].description`	string	Extrait / description du résultat.

Exemples

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);

Facturation

Chaque appel déduit de votre crédit d'API prépayé. Un nombre élevé de résultats (num au-dessus de 10) peut se déployer en plusieurs récupérations de pages en amont et est facturé en conséquence. Consultez votre solde à tout moment via Utilisation.