Zum Hauptinhalt springen

​
Überblick

Du kannst jetzt auch die Olostep API-Endpunkte mit Pay-per-use-Zahlungen unter Verwendung von Stablecoins nutzen. Diese Endpunkte verwenden das x402-Zahlungsprotokoll, das Pay-per-use-Zugriff mit Stablecoin-Zahlungen ermöglicht. Jede Anfrage erfordert einen Zahlungsheader zur Authentifizierung und Bezahlung.
Pay-Per-Use EndpunkteAlle unten aufgeführten Endpunkte akzeptieren Stablecoin-Zahlungen über das x402-Protokoll. Kein Abonnement erforderlich - zahle nur für das, was du nutzt.

​
Authentifizierung

Füge den Zahlungsheader zu deinen Anfragen hinzu: 
X-Payment: {{paymentHeader}}
Die Zahlung wird automatisch verarbeitet und überprüft, bevor deine Anfrage erfüllt wird.

​
Olostep API

​
Zahlungsfähige Endpunkte

​
POST /v1/maps

Dieser Endpunkt ermöglicht es Benutzern, alle URLs auf einer bestimmten Website zu erhalten. Bei komplexen Websites kann dies bis zu 120 Sekunden dauern. Für große Websites werden die Ergebnisse mit cursor-basierter Paginierung aufgeteilt. Preis: $0.01 pro Anfrage Netzwerk: base (USDC) 
curl -X POST 'https://api.olostep.com/x402/v1/maps' \\
  -H 'Content-Type: application/json' \\
  -H 'X-Payment: {{paymentHeader}}' \\
  -d '{
    "url": "example",
    "search_query": "example",
    "top_n": 123,
    "include_subdomain": true,
    "include_urls": "",
    "exclude_urls": "",
    "cursor": "example"
  }'

​
POST /v1/scrapes

Starte einen Webseiten-Scrape Preis: $0.01 pro Anfrage Netzwerk: base (USDC) 
curl -X POST 'https://api.olostep.com/x402/v1/scrapes' \\
  -H 'Content-Type: application/json' \\
  -H 'X-Payment: {{paymentHeader}}' \\
  -d '{
    "url_to_scrape": "example",
    "wait_before_scraping": "",
    "formats": "",
    "remove_css_selectors": "example",
    "actions": "",
    "country": "example",
    "transformer": "example",
    "remove_images": true,
    "remove_class_names": "",
    "parser": "",
    "llm_extract": "",
    "links_on_page": "",
    "screen_size": "",
    "metadata": ""
  }'

​
POST /v1/crawls

Startet einen neuen Crawl. Du erhältst eine id, um den Fortschritt zu verfolgen. Der Vorgang kann je nach Website und den Parametern Tiefe und Seiten 1-10 Minuten dauern. Preis: Dynamisch - pro Anfrage basierend auf Nutzung berechnet
Dieser Endpunkt verwendet dynamische Preisgestaltung. Die tatsächlichen Kosten werden durch deine Anfrageparameter bestimmt und vor der Verarbeitung in der 402 Payment Required-Antwort angezeigt.
Netzwerk: base (USDC) 
curl -X POST 'https://api.olostep.com/x402/v1/crawls' \\
  -H 'Content-Type: application/json' \\
  -H 'X-Payment: {{paymentHeader}}' \\
  -d '{
    "start_url": "example",
    "max_pages": 123,
    "include_urls": "",
    "exclude_urls": "",
    "max_depth": 123,
    "include_external": true,
    "include_subdomain": true,
    "search_query": "example",
    "top_n": 123,
    "webhook_url": "example",
    "timeout": 123
  }'

​
POST /v1/answers

Die KI führt Aktionen wie das Suchen und Durchsuchen von Webseiten durch, um die Antwort auf die gestellte Aufgabe zu finden. Die Ausführungszeit beträgt 3-30 Sekunden, abhängig von der Komplexität. Für längere Aufgaben verwende stattdessen den Agenten-Endpunkt. Preis: $0.05 pro Anfrage Netzwerk: base (USDC) 
curl -X POST 'https://api.olostep.com/x402/v1/answers' \\
  -H 'Content-Type: application/json' \\
  -H 'X-Payment: {{paymentHeader}}' \\
  -d '{
    "task": "example",
    "json_format": ""
  }'

​
Standardendpunkte

Diese Endpunkte erfordern keine Zahlung:
  • GET /v1/crawls/{crawl_id} - Ruft Informationen über einen bestimmten Crawl ab.
  • GET /v1/batches/{batch_id}/items - Ruft die Liste der für ein Batch verarbeiteten Elemente ab. Du kannst dann die retrieve_id verwenden, um den Inhalt mit dem Retrieve-Endpunkt zu erhalten.
  • GET /v1/crawls/{crawl_id}/pages - Ruft die Liste der Seiten für einen bestimmten Crawl ab.
  • GET /v1/batches/{batch_id} - Ruft den Status und Fortschrittsinformationen über ein Batch ab. Um den Inhalt für ein Batch abzurufen, siehe hier.
  • GET /v1/answers/{answer_id} - Dieser Endpunkt ruft eine zuvor abgeschlossene Antwort anhand ihrer ID ab.
  • GET /v1/scrapes/{scrape_id} - Kann verwendet werden, um die Antwort für einen Scrape abzurufen.
  • GET /v1/retrieve - Ruft Seiteninhalte von verarbeiteten Batches und Crawl-URLs ab.

​
Wie x402 funktioniert

Der Zahlungsfluss wird automatisch vom x402 SDK abgewickelt:
  1. Anfrage stellen - Sende eine Anfrage an den Endpunkt
  2. Zahlung erforderlich - Server antwortet mit Zahlungsanforderungen (402-Status)
  3. Automatische Zahlung - SDK erstellt und sendet die Zahlung automatisch
  4. Antwort erhalten - Erhalte deine API-Antwort

​
Erste Schritte

Installiere das x402 SDK für deine Sprache: 
# Node.js
npm install x402-fetch viem

# Python  
pip install x402 eth-account

​
Beispielverwendung

import { wrapFetchWithPayment } from "x402-fetch";
import { privateKeyToAccount } from "viem/accounts";

const account = privateKeyToAccount(process.env.PRIVATE_KEY);
const fetchWithPayment = wrapFetchWithPayment(fetch, account);

// Mache eine bezahlte Anfrage - Zahlung erfolgt automatisch
const response = await fetchWithPayment("https://api.olostep.com/x402/v1/maps", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({ /* deine Daten */ })
});

const result = await response.json();
console.log(result);

​
Mehr erfahren

Powered by Orthogonal