POST
/search
Zoeken en distilleren

Voert een Google-webzoekopdracht uit voor de opgegeven query en distilleert elk resultaat met de gevraagde formats. Elk resultaat meldt zijn eigen success-vlag.

Autorisatie

YOUR_API_KEY
AutorisatieBearer <token>

Haal je API-key op uit het Thunderbit Dashboard. Header-formaat: Authorization: Bearer YOUR_API_KEY

In: header

Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

query*stringvereist

Zoekopdracht (max. 500 tekens).

Voorbeeld:best web scraping tools 2026
limitintegerstandaard:5

Aantal resultaten om terug te geven (1–10, standaard 5).

Vereist bereik:1 <= x <= 10
Voorbeeld:
5
sitestring

Beperkt de zoekopdracht tot één domein.

Voorbeeld:techcrunch.com
formatsany[]

Uitvoerformaten toegepast op elke resultaatpagina (zelfde structuur als de formats-array van Distill).

Voorbeeld:
[
  "markdown",
  {
    "type": "summary"
  }
]
timeoutintegerstandaard:30000

Distill-timeout per resultaat in milliseconden (standaard 30000, max 60000).

Vereist bereik:5000 <= x <= 60000

Antwoord

application/json

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

successboolean
Voorbeeld:
true
dataobject
Onderliggende kenmerken tonen
querystring

Echo van de invoerquery.

totalinteger

Aantal teruggegeven resultaten.

successfulinteger

Aantal resultaten waarvan de Distill-fase is geslaagd.

credits_usedinteger

Totaal aantal in rekening gebrachte credits voor dit verzoek.

resultsobject[]
Onderliggende kenmerken tonen
urlstring

URL van het resultaat.

titlestring

Titel van het zoekresultaat.

snippetstring

Zoekresultaatfragment van Google.

positioninteger

Op 1 gebaseerde positie in de zoekresultaten.

successboolean

Geeft aan of Distill per resultaat is geslaagd.

markdownstring

Gedistilleerde Markdown voor dit resultaat (indien gevraagd).

summarystring

Samenvatting van het resultaat (indien gevraagd).

answerstring

Antwoord van het question-formaat (indien gevraagd).

highlightsstring[]

Gemarkeerde passages (indien gevraagd).

linksobject[]

Links geextraheerd van de resultaatpagina (indien gevraagd).

Onderliggende kenmerken tonen
textstring

Visible link text.

Voorbeeld:Read more
hrefstring

Resolved absolute URL.

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

Afbeeldingen geextraheerd van de resultaatpagina (indien gevraagd).

Onderliggende kenmerken tonen
srcstring

Image source URL.

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

Image alt text.

Voorbeeld:Hero banner
widthinteger

Image width in pixels.

heightinteger

Image height in pixels.

errorstring

Distill-foutmelding voor dit resultaat (alleen wanneer success=false).