Schnellreferenz für KI-Agenten
Schnellreferenz für KI-Agenten
- Endpoint:
POST https://api.olostep.com/v1/scrapes(auch/v1/batchesund/v1/crawls) (auth:Authorization: Bearer <YOUR_API_KEY>) - Erforderlich:
url_to_scrape,formats: ["json"],parser: { "id": "@olostep/..." } - Vorgefertigte Parser-IDs:
@olostep/google-search,@olostep/amazon-it-product,@olostep/extract-emails,@olostep/extract-calendars,@olostep/extract-socials - Batches / Crawls: Batches verwenden
parser: { "id": "..." }; Crawls verwenden die ID als String inscrape_options.parser - Rückgabe:
result.json_content(stringifiziertes JSON — parsen) undresult.json_hosted_url - Sync oder async: Sync bei
/v1/scrapes; async bei Batches und Crawls (abrufen mitGET /v1/retrieve?retrieve_id=...&formats=json) - Verwende stattdessen: Einmalige Seiten oder sich ändernde Layouts → LLM-Extraktion
Vorgefertigte Parser
Wir bieten mehrere vorgefertigte Parser für beliebte Websites an:- Google-Suche:
@olostep/google-search - Amazon-Produkt:
@olostep/amazon-it-product - E-Mail extrahieren:
@olostep/extract-emails - Kalender extrahieren:
@olostep/extract-calendars - Soziale Netzwerke extrahieren:
@olostep/extract-socials - TikTok-Datenextraktion: Kontaktiere uns, um die Parser-ID zu erhalten
- Google News: Kontaktiere uns, um die Parser-ID zu erhalten
- Google Maps: Kontaktiere uns, um die Parser-ID zu erhalten
Beispielverwendung
Antwortformat
Wenn du eine Anfrage an die Olostep API mit dem Parser-Format stellst, erhältst du eine JSON-Antwort wie im folgenden Beispiel:- Grundlegende Anfrageninformationen:
id,object,createdZeitstempel,url_to_scrape - Ergebnisobjekt mit URLs zum Zugriff auf verschiedene Datenformate
- json_content mit strukturierten JSON-Ergebnissen, einschließlich:
searchParameters: Informationen zur SuchanfrageknowledgeGraph: Detaillierte Informationen zum Suchthema (falls verfügbar)organic: Liste der Suchergebnisse mit Titel, Link, Position und SnippetpeopleAlsoAsk: Verwandte Fragen, die Benutzer häufig suchenrelatedSearches: Vorgeschlagene verwandte Suchanfragen
json_content ist der Hauptteil der Antwort mit den strukturierten JSON-Ergebnissen. Du kannst den JSON-Inhalt direkt aus der Antwort abrufen oder die bereitgestellte gehostete URL in der Antwort verwenden.
Strukturierte Antwort: json_content
json_hosted_url in der Antwort zugreifen:
- Strukturiertes JSON: Beispiel-JSON anzeigen
formats-Parameter einschließen und Olostep wird sie in der Antwort zurückgeben und gehostete URLs für jedes Format bereitstellen.
Benötigst du einen benutzerdefinierten Parser?
Wenn du einen Parser für eine bestimmte Website oder die ID eines vorgefertigten Parsers benötigst:- Kontaktiere uns unter info@olostep.com