Zum Hauptinhalt springen
Beginne mit dem, was du hast und was du zurückhaben möchtest. Jeder Endpunkt verwendet die Basis-URL https://api.olostep.com und den Header Authorization: Bearer <YOUR_API_KEY> (siehe Authentifizierung).

Nach Ziel

Häufige Entscheidungen

  • Scrape vs. Crawl: Scrape, wenn du die genaue URL kennst. Crawl, wenn du viele Seiten von einer Website möchtest und sie nicht selbst auflisten willst.
  • Map vs. Crawl: Map gibt nur URLs zurück und ist schnell. Verwende es, um zuerst Seiten auszuwählen, dann scrape oder batche nur diese.
  • Crawl vs. Batch: Crawl entdeckt Seiten, indem es Links folgt. Batch nimmt eine Liste von URLs, die du bereits hast, bis zu Tausenden auf einmal.
  • Suche vs. Antworten: Suche gibt Links zurück, die du (oder dein Agent) lesen kannst. Antworten liest die Seiten für dich und gibt eine einzelne Antwort mit Zitaten zurück.
  • Parsers vs. LLM-Extraktion: Verwende einen Parser, wenn einer für die Seite existiert. Er ist schneller und gibt jedes Mal die gleichen Felder zurück. Verwende LLM-Extraktion für alles andere.

Asynchrone Endpunkte

Crawls und Batches laufen im Hintergrund. Jeder gibt sofort eine id zurück. Poll GET /v1/crawls/{id} oder GET /v1/batches/{id} bis der status completed ist, dann hole die Ergebnisse. Stoppe das Polling, wenn der status failed ist. Ein Crawl kann immer noch als completed enden mit 0 Seiten (prüfe pages_count), und ein Batch kann als completed enden mit einigen fehlgeschlagenen Elementen (liste sie mit ?status=failed). Jede Feature-Seite zeigt den vollständigen Ablauf.

Andere Möglichkeiten, Olostep aufzurufen