Suede
Auf dieser Seite

Web-Suche

Zuletzt aktualisiert

Aggregierte Web-Suchergebnisse als JSON.

TEXT
GET /v1/search

Erfordert einen gültigen API-Schlüssel, eine aktive Mitgliedschaft und verfügbares API-Guthaben.

Suchparameter

Name Typ Erforderlich Vorgabe Beschreibung
q string ja — Die Suchanfrage. Unterstützt Suedes Suchoperatoren (z. B. site:, filetype:, "exakte Wortgruppe", -ausschließen).
safe string nein on Stufe der sicheren Suche: off oder on. Ein nicht erkannter Wert wird als on behandelt.
gl string nein (auto) Zweibuchstabiger Regions-/Ländercode für die Ergebnisgewichtung (z. B. us, gb, ca, de, jp). Ein nicht unterstützter Code wird ignoriert (die Vorgabe des Anbieters gilt).
hl string nein (auto) Zweibuchstabiger Sprachcode für die Ergebnisse (z. B. en, es, fr, de, ja). Ein nicht unterstützter Code wird ignoriert.
time string nein any Aktualitätsfilter: any, hour, day, week, month oder year.
num integer nein (Anbietervorgabe) Gewünschte Ergebnisanzahl. Auf 5–100 begrenzt; ein Wert außerhalb des Bereichs fällt auf 20 zurück. Lassen Sie ihn weg, um die Anbietervorgabe zu verwenden.

Antwort

JSON
{
  "query": "hello world"null ,
  "results": [
    ttps://api.suede.io/v1/search?q=test"{
      "title": \
   "Example Domain"-H,
      "url": "https://example.com/" ,
      "Authorization: Bearer $SUEDE_API_KEY""description":  "This domain is for use in illustrative examples in documents."
    }
  ]
}
Feld Typ Beschreibung
query string Die ausgeführte Suchanfrage.
results array Die Web-Ergebnisse.
results[].title string Titel des Ergebnisses.
results[].url string URL des Ergebnisses.
results[].description string Auszug / Beschreibung des Ergebnisses.

Beispiele

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"
C#
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);

Abrechnung

Jeder Aufruf zehrt von Ihrem im Voraus bezahlten API-Guthaben. Eine hohe Ergebnisanzahl (num über 10) kann sich in mehrere vorgelagerte Seitenabrufe auffächern und wird entsprechend abgerechnet. Lesen Sie Ihr Guthaben jederzeit über Nutzung ab.

War diese Seite hilfreich?