Thunderbit Open API home page
SupportConsole API
Extract

Extraction Structurée par IA

POST
/extract
Extraction Structurée par IA

Extrayez des données structurées à partir de pages web en utilisant l'IA. Définissez la structure de sortie souhaitée avec le schéma JSON, et notre IA extraira intelligemment les informations.

Cas d'Utilisation :

  • Extraire des informations de produits depuis des pages e-commerce
  • Parser des offres d'emploi en format structuré
  • Extraire des informations de contact et des détails d'entreprise
  • Convertir des articles de presse en données structurées
  • Scraper des tableaux de prix et des spécifications

Comment Ça Fonctionne :

  1. Fournissez une URL et un schéma JSON définissant la structure souhaitée
  2. Notre IA analyse le contenu de la page
  3. Extrait les données correspondant à votre schéma
  4. Retourne une sortie JSON validée

Définition du Schéma :

Utilisez le schéma JSON pour définir la structure de sortie souhaitée :

  • Types de champs : string, number, boolean, array, object
  • Descriptions des champs : Aidez l'IA à comprendre ce qu'il faut extraire
  • Champs requis : Marquez les champs critiques comme requis
  • Structures imbriquées : Support pour des données complexes et imbriquées

Exemple de Schéma :

{
  "type": "object",
  "properties": {
    "title": {
      "type": "string",
      "description": "Nom ou titre du produit"
    },
    "price": {
      "type": "number",
      "description": "Prix actuel en USD"
    },
    "availability": {
      "type": "boolean",
      "description": "Si le produit est en stock"
    },
    "features": {
      "type": "array",
      "items": {"type": "string"},
      "description": "Liste des caractéristiques clés du produit"
    }
  },
  "required": ["title", "price"]
}

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.

url*stringrequis

L'URL de la page web à partir de laquelle extraire les données

Exemple :https://thunderbit.com/playground
schemaobject

JSON Schema. Optionnel — s'il est omis, Thunderbit génère automatiquement un schéma à partir du contenu de la page.

Exemple :
{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Product name"
    },
    "price": {
      "type": "number",
      "description": "Product price"
    },
    "currency": {
      "type": "string",
      "description": "Currency unit"
    }
  },
  "required": [
    "name",
    "price"
  ]
}
timeoutnumberdéfaut :60000

Délai d'expiration de la requête en millisecondes, par défaut 30000

Plage requise :5000 <= x <= 120000
Exemple :
60000
waitFornumberdéfaut :0

Temps d'attente (en millisecondes) après le chargement de la page pour le rendu du contenu dynamique (par défaut : 0, max : 10000)

Plage requise :0 <= x <= 10000
Exemple :
2000
renderModestringdéfaut :"none"

Mode de rendu JavaScript. none = pas de rendu JS (par défaut) ; basic = rendu standard ; full = attente prolongée pour le contenu dynamique

Valeur dans"none" | "basic" | "full"
formatsany[]

Formats de sortie (même structure que le tableau formats de Distill).

Exemple :
[
  "markdown",
  "links",
  "images"
]

Réponse

application/json

Success response

successboolean
Exemple :
true
dataobject
Afficher les attributs enfants
urlstring
Exemple :https://thunderbit.com/playground
dataobject[]

Extracted structured data matching your schema, returned as an array where each item is a key-value map

Exemple :
[
  {
    "name": "iPhone 15 Pro",
    "price": 999,
    "currency": "USD",
    "availability": true,
    "rating": 4.7,
    "features": [
      "A17 Pro chip with 6-core GPU",
      "Pro camera system with 48MP main camera",
      "Titanium design with textured matte glass"
    ]
  }
]
linksobject[]

Liens extraits de la page.

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.

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.

summarystring

Résumé de la page (format LLM).

answerstring

Réponse à la question fournie dans le format question.

highlightsstring[]

Passages mis en évidence.

metadataobject
Afficher les attributs enfants
titlestring

Page title extracted from tag or Open Graph

Exemple :iPhone 15 Pro - Apple
descriptionstring

Meta description or excerpt

Exemple :The ultimate iPhone with A17 Pro chip.
languagestring

Detected language code (ISO 639-1)

Exemple :en
authorstring

Article author if available

Exemple :
null
publishedDatestring

Publication date if available

Exemple :
null
imagestring

Featured image URL from Open Graph or Twitter Card

Exemple :https://example.com/product/iphone-15-pro.jpg
sourceURLstring

URL source

Exemple :https://example.com/product/iphone-15-pro
statusCodeinteger

Code de statut HTTP

Exemple :
200
contentLengthinteger

Length of the markdown content in characters

Exemple :
5000