FeaturePOST /v1/extract

DOM Extraction

Named Fields per Selector oder fertige Inspect-Packs — Rohdaten aus dem gerenderten DOM.

Was du mit Extract & Inspect machen kannst

Zieh gezielt Felder per CSS-Selector oder hole ein fertiges Inspect-Pack (Meta, Headings, Links, …). Ideal für Scraping-light, Content-Checks und Agent-Inputs.

Named Fields per Selector (text, html, attribute, count, list, exists)
Inspect-Packs über include[] ohne eigene Selectors zu schreiben
Warten auf Selectors / Cookie-Banner vor dem Extract
Strukturierte data-Objekte für CI und Automationen

API Call

editable

Request body

{'{'}

{'}'}

Extract: Selector und Viewport anpassen.

Response

Noch kein Ergebnis — API Call ausführen.

Endpoints & Parameter

Endpoint wählen — darunter siehst du eine beispielhafte Anfrage und die Erklärung aller relevanten Parameter.

POST /v1/extract

Extrahiert benannte Felder über CSS-Selectors.

Beispiel-Anfrage

json

{
  "url": "https://example.com",
  "width": 1280,
  "height": 720,
  "fields": [
    {
      "name": "title",
      "selector": "h1",
      "type": "text"
    },
    {
      "name": "cta_href",
      "selector": "a.primary",
      "type": "attribute",
      "attribute": "href"
    },
    {
      "name": "nav_links",
      "selector": "nav a",
      "type": "count"
    }
  ],
  "wait_for_selector": "h1",
  "dismiss_cookie_banner": true
}

Parameter

urlstring required
Ziel-URL.
fieldsarray (≤50) required
Oder template_id — jedes Feld: name, selector, type (+ attribute bei type=attribute).
fields[].type'text'|'html'|'attribute'|'count'|'list'|'exists'
Wie der Selector ausgewertet wird.
template_idstring
Alternative zu fields: gespeicherte Extract-Vorlage.
width / heightnumber
Viewport.
wait_for / wait_timeout_msvarious
Warten auf Selector vor dem Extract.
dismiss_cookie_bannerboolean
Versucht bekannte Cookie-Banner zu schließen, bevor gemessen/geprüft wird.
wait_for_selectorstring
Wartet auf CSS-Selector, bevor weitergemacht wird.
wait_ms / settle_msnumber
Zusätzliche Wartezeit nach dem Laden (je nach Endpoint).
devicestring
Playwright-Device-Preset; überschreibt width/height/UA wenn gesetzt.
color_scheme'light'|'dark'|'no-preference'
Bevorzugtes Farbschema im Browser.
block_adsboolean
Blockiert bekannte Ad-/Tracker-Requests.
record_harboolean
Zeichnet optional HAR auf (wo vom Endpoint unterstützt).
respect_robotsboolean
Robots.txt beachten (Default: an).