POST
/search
Rechercher et distiller

Exécute une recherche web Google pour la requête fournie et distille chaque résultat avec les formats demandés. Chaque résultat indique son propre indicateur success.

Autorisation

YOUR_API_KEY
AutorisationBearer <token>

Récupère ta clé API depuis le Thunderbit Dashboard. Format d'en-tête : Authorization: Bearer YOUR_API_KEY

Dans: header

Corps

application/json

TypeScript Definitions

Use the request body type in TypeScript.

query*stringrequis

Requête de recherche (max. 500 caractères).

Exemple :best web scraping tools 2026
limitintegerdéfaut :5

Nombre de résultats à retourner (1–10, par défaut 5).

Plage requise :1 <= x <= 10
Exemple :
5
sitestring

Restreint la recherche à un seul domaine.

Exemple :techcrunch.com
formatsany[]

Formats de sortie appliqués à chaque page de résultat (même structure que le tableau formats de Distill).

Exemple :
[
  "markdown",
  {
    "type": "summary"
  }
]
timeoutintegerdéfaut :30000

Délai d'expiration Distill par résultat en millisecondes (par défaut 30000, max 60000).

Plage requise :5000 <= x <= 60000

Réponse

application/json

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

successboolean
Exemple :
true
dataobject
Afficher les attributs enfants
querystring

Écho de la requête en entrée.

totalinteger

Nombre de résultats retournés.

successfulinteger

Nombre de résultats dont l'étape Distill a réussi.

credits_usedinteger

Total des crédits facturés pour cette requête.

resultsobject[]
Afficher les attributs enfants
urlstring

URL du résultat.

titlestring

Titre du résultat de recherche.

snippetstring

Extrait du résultat de recherche Google.

positioninteger

Rang basé sur 1 dans les résultats de recherche.

successboolean

Indique si Distill a réussi pour ce résultat.

markdownstring

Markdown distillé pour ce résultat (si demandé).

summarystring

Résumé du résultat (si demandé).

answerstring

Réponse du format question (si demandé).

highlightsstring[]

Passages mis en évidence (si demandé).

linksobject[]

Liens extraits de la page de résultat (si demandé).

Afficher les attributs enfants
textstring

Visible link text.

Exemple :Read more
hrefstring

Resolved absolute URL.

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

Images extraites de la page de résultat (si demandé).

Afficher les attributs enfants
srcstring

Image source URL.

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

Image alt text.

Exemple :Hero banner
widthinteger

Image width in pixels.

heightinteger

Image height in pixels.

errorstring

Message d'erreur Distill pour ce résultat (uniquement si success=false).