API Documentation

Demnächst#

Die vier Endpunkte unten sind in privater Beta. Sie sind heute mit deinem normalen API-Schlüssel aufrufbar, und an der Ops-Abrechnung ändert sich nichts: Jeder Aufruf zieht von deinem Monatskontingent ab, genau wie unter Rate-Limits und Kontingente beschrieben.

Private Beta. Diese vier beantworten heute echte Requests, sind aber nicht angekündigt, nicht allgemein verfügbar, und ihre Request- und Response-Formen können sich ohne Vorankündigung ändern. Nichts davon trägt eine Stabilitäts- oder Supportzusage, halte es also aus allem heraus, was tragend ist. Heute allgemein verfügbar auf V2: Perceive und Ingest.

Zwei Phasen#

Phase 1 ist Distill. Es wird zuerst allgemein verfügbar, für sich allein.

Phase 2 sind Lookup, Watch und Discover. Diese drei folgen gemeinsam, nach Distill.

Die vier Seiten#

  • Distill (Phase 1) nimmt eine URL-Liste und ein von dir geliefertes Schema und gibt Daten exakt in dieser Form zurück.
  • Lookup (Phase 2) führt eine Websuche aus und kann die Top-Treffer im selben Roundtrip rendern.
  • Watch (Phase 2) rendert eine Seite in festem Takt neu, vergleicht jede Prüfung mit der letzten und benachrichtigt dich, wenn sie sich ändert.
  • Discover (Phase 2) listet die URLs einer Website aus ihrer Sitemap plus einem HTTP-Crawl auf, ohne Rendering und ohne gespeichertes Artefakt.

Wie du erfährst, wann sie erscheinen#

Behalte das Changelog im Auge. Jedes Release wird dort veröffentlicht, und unter /changelog/feed.xml gibt es einen RSS-Feed, falls du nicht von Hand nachsehen willst. Nichts wird still und leise allgemein verfügbar: Erreicht ein Endpunkt diesen Status, wandert seine Seite aus diesem Abschnitt heraus zu Endpunkte.

Für alles Tragende baue auf der allgemein verfügbaren Oberfläche auf. Perceive deckt das Rendern einzelner Seiten ab, und Ingest deckt das Crawlen einer Website in RAG-Chunks ab. Beide werden unter V1 und V2 beschrieben.

← compress-image Distill (Phase 1) →