Thunderbit Open API home page
SupportAPI-Konsole
Extract

KI-gestützte strukturierte Extraktion

POST
/extract
KI-gestützte strukturierte Extraktion

Strukturierte Daten aus Webseiten mithilfe von KI extrahieren. Definieren Sie Ihre gewünschte Ausgabestruktur mit JSON-Schema, und unsere KI extrahiert die Informationen intelligent.

Anwendungsfälle:

  • Produktinformationen aus E-Commerce-Seiten extrahieren
  • Stellenanzeigen in strukturiertes Format parsen
  • Kontaktinformationen und Geschäftsdaten extrahieren
  • Nachrichtenartikel in strukturierte Daten konvertieren
  • Preistabellen und Spezifikationen scrapen

So funktioniert es:

  1. Eine URL und ein JSON-Schema mit Ihrer gewünschten Struktur bereitstellen
  2. Unsere KI analysiert den Seiteninhalt
  3. Extrahiert Daten entsprechend Ihrem Schema
  4. Gibt validierte JSON-Ausgabe zurück

Schema-Definition:

Verwenden Sie JSON-Schema, um Ihre gewünschte Ausgabestruktur zu definieren:

  • Feldtypen: string, number, boolean, array, object
  • Feldbeschreibungen: Helfen der KI zu verstehen, was extrahiert werden soll
  • Pflichtfelder: Kritische Felder als erforderlich markieren
  • Verschachtelte Strukturen: Unterstützung für komplexe, verschachtelte Daten

Beispiel-Schema:

{
  "type": "object",
  "properties": {
    "title": {
      "type": "string",
      "description": "Produktname oder Titel"
    },
    "price": {
      "type": "number",
      "description": "Aktueller Preis in USD"
    },
    "availability": {
      "type": "boolean",
      "description": "Ob das Produkt auf Lager ist"
    },
    "features": {
      "type": "array",
      "items": {"type": "string"},
      "description": "Liste der wichtigsten Produktmerkmale"
    }
  },
  "required": ["title", "price"]
}

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.

url*stringerforderlich

Die URL der Webseite, aus der Daten extrahiert werden sollen

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

JSON Schema. Optional — wenn weggelassen, generiert Thunderbit automatisch ein Schema aus dem Seiteninhalt.

Beispiel:
{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Product name"
    },
    "price": {
      "type": "number",
      "description": "Product price"
    },
    "currency": {
      "type": "string",
      "description": "Currency unit"
    }
  },
  "required": [
    "name",
    "price"
  ]
}
timeoutnumberStandard:60000

Anfrage-Timeout in Millisekunden, Standard 30000

Erforderlicher Bereich:5000 <= x <= 120000
Beispiel:
60000
waitFornumberStandard:0

Wartezeit (in Millisekunden) nach dem Laden der Seite, damit dynamische Inhalte gerendert werden können (Standard: 0, Max: 10000)

Erforderlicher Bereich:0 <= x <= 10000
Beispiel:
2000
renderModestringStandard:"none"

JavaScript-Rendering-Modus. none = kein JS-Rendering (Standard); basic = Standard-Rendering; full = erweitertes Warten auf dynamische Inhalte

Wert aus"none" | "basic" | "full"
formatsany[]

Ausgabeformate (gleiche Struktur wie das Distill-formats-Array).

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

Antwort

application/json

Success response

successboolean
Beispiel:
true
dataobject
Untergeordnete Attribute anzeigen
urlstring
Beispiel:https://thunderbit.com/playground
dataobject[]

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

Beispiel:
[
  {
    "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[]

Aus der Seite extrahierte Links.

Untergeordnete Attribute anzeigen
textstring

Visible link text.

Beispiel:Read more
hrefstring

Resolved absolute URL.

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

Aus der Seite extrahierte Bilder.

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.

summarystring

Seitenzusammenfassung (LLM-Format).

answerstring

Antwort auf die im Format question angegebene Frage.

highlightsstring[]

Hervorgehobene Passagen.

metadataobject
Untergeordnete Attribute anzeigen
titlestring

Page title extracted from tag or Open Graph

Beispiel:iPhone 15 Pro - Apple
descriptionstring

Meta description or excerpt

Beispiel:The ultimate iPhone with A17 Pro chip.
languagestring

Detected language code (ISO 639-1)

Beispiel:en
authorstring

Article author if available

Beispiel:
null
publishedDatestring

Publication date if available

Beispiel:
null
imagestring

Featured image URL from Open Graph or Twitter Card

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

Quell-URL

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

HTTP-Statuscode

Beispiel:
200
contentLengthinteger

Length of the markdown content in characters

Beispiel:
5000