Thunderbit Open API home page
SupportAPI-Konsole
Search

Suchen und destillieren

POST
/search
Suchen und destillieren

Führt eine Google-Websuche für die angegebene Abfrage aus und destilliert jedes Ergebnis mit den angeforderten Formaten. Jedes Ergebnis meldet seinen eigenen success-Wert.

Autorisierung

YOUR_API_KEY
AutorisierungBearer <token>

Hol deinen API-Key aus dem Thunderbit Dashboard. Header-Format: Authorization: Bearer YOUR_API_KEY

In: header

Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

query*stringerforderlich

Suchanfrage (max. 500 Zeichen).

Beispiel:best web scraping tools 2026
limitintegerStandard:5

Anzahl der zurückzugebenden Ergebnisse (1–10, Standard 5).

Erforderlicher Bereich:1 <= x <= 10
Beispiel:
5
sitestring

Beschränkt die Suche auf eine einzelne Domain.

Beispiel:techcrunch.com
formatsany[]

Ausgabeformate, die auf jede Ergebnisseite angewendet werden (gleiche Struktur wie das Distill-formats-Array).

Beispiel:
[
  "markdown",
  {
    "type": "summary"
  }
]
timeoutintegerStandard:30000

Distill-Timeout pro Ergebnis in Millisekunden (Standard 30000, Maximum 60000).

Erforderlicher Bereich:5000 <= x <= 60000

Antwort

application/json

Search succeeded. Per-result Distill outcomes are reported individually in `data.results[].success`.

successboolean
Beispiel:
true
dataobject
Untergeordnete Attribute anzeigen
querystring

Echo der eingegebenen Abfrage.

totalinteger

Anzahl der zurückgegebenen Ergebnisse.

successfulinteger

Anzahl der Ergebnisse, bei denen die Distill-Phase erfolgreich war.

credits_usedinteger

Gesamtzahl der für diese Anfrage berechneten Credits.

resultsobject[]
Untergeordnete Attribute anzeigen
urlstring

Ergebnis-URL.

titlestring

Titel des Suchergebnisses.

snippetstring

Ergebnis-Snippet von Google.

positioninteger

1-basierter Rang in den Suchergebnissen.

successboolean

Gibt an, ob Distill pro Ergebnis erfolgreich war.

markdownstring

Destilliertes Markdown für dieses Ergebnis (falls angefordert).

summarystring

Zusammenfassung des Ergebnisses (falls angefordert).

answerstring

Antwort des question-Formats (falls angefordert).

highlightsstring[]

Hervorgehobene Passagen (falls angefordert).

linksobject[]

Aus der Ergebnisseite extrahierte Links (falls angefordert).

Untergeordnete Attribute anzeigen
textstring

Visible link text.

Beispiel:Read more
hrefstring

Resolved absolute URL.

Beispiel:https://example.com/article
imagesobject[]

Aus der Ergebnisseite extrahierte Bilder (falls angefordert).

Untergeordnete Attribute anzeigen
srcstring

Image source URL.

Beispiel:https://example.com/hero.png
altstring

Image alt text.

Beispiel:Hero banner
widthinteger

Image width in pixels.

heightinteger

Image height in pixels.

errorstring

Distill-Fehlermeldung für dieses Ergebnis (nur bei success=false).