Naar hoofdinhoud gaan

​
Overzicht

Je kunt nu ook de Olostep API-eindpunten gebruiken met pay-per-use betalingen via stablecoins. Deze eindpunten maken gebruik van het x402 betalingsprotocol, waarmee pay-per-use toegang mogelijk is met betalingen in stablecoins. Elke aanvraag vereist een betalingsheader voor authenticatie en betaling.
Pay-Per-Use EindpuntenAlle hieronder vermelde eindpunten accepteren betalingen in stablecoins via het x402 protocol. Geen abonnement vereist - betaal alleen voor wat je gebruikt.

​
Authenticatie

Voeg de betalingsheader toe aan je aanvragen: 
X-Payment: {{paymentHeader}}
De betaling wordt automatisch verwerkt en geverifieerd voordat je aanvraag wordt uitgevoerd.

​
Olostep API

​
Betalingsgeactiveerde Eindpunten

​
POST /v1/maps

Dit eindpunt stelt gebruikers in staat om alle urls op een bepaalde website te verkrijgen. Het kan tot 120 seconden duren voor complexe websites. Voor grote websites worden resultaten gepagineerd met cursor-gebaseerde paginering. Prijs: $0.01 per aanvraag Netwerk: 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

Start een webpagina scraping Prijs: $0.01 per aanvraag Netwerk: 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

Start een nieuwe crawl. Je ontvangt een id om de voortgang bij te houden. De operatie kan 1-10 minuten duren, afhankelijk van de site en de diepte- en pagina’s-parameters. Prijs: Dynamisch - berekend per aanvraag op basis van gebruik
Dit eindpunt gebruikt dynamische prijzen. De werkelijke kosten worden bepaald door je aanvraagparameters en worden getoond in de 402 Payment Required-respons voordat de verwerking plaatsvindt.
Netwerk: 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

De AI zal acties uitvoeren zoals zoeken en bladeren door webpagina’s om het antwoord op de gegeven taak te vinden. De uitvoeringstijd is 3-30s afhankelijk van de complexiteit. Voor langere taken, gebruik in plaats daarvan het agent-eindpunt. Prijs: $0.05 per aanvraag Netwerk: 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": ""
  }'

​
Standaard Eindpunten

Deze eindpunten vereisen geen betaling:
  • GET /v1/crawls/{crawl_id} - Haalt informatie op over een specifieke crawl.
  • GET /v1/batches/{batch_id}/items - Haalt de lijst van verwerkte items voor een batch op. Je kunt dan de retrieve_id gebruiken om de inhoud met het Retrieve Eindpunt te verkrijgen.
  • GET /v1/crawls/{crawl_id}/pages - Haalt de lijst van pagina’s voor een specifieke crawl op.
  • GET /v1/batches/{batch_id} - Haalt de status- en voortgangsinformatie over een batch op. Om de inhoud voor een batch op te halen, zie hier.
  • GET /v1/answers/{answer_id} - Dit eindpunt haalt een eerder voltooid antwoord op via zijn ID.
  • GET /v1/scrapes/{scrape_id} - Kan worden gebruikt om de respons voor een scrape op te halen.
  • GET /v1/retrieve - Haal pagina-inhoud op van verwerkte batches en crawls urls.

​
Hoe x402 Werkt

De betalingsstroom wordt automatisch afgehandeld door de x402 SDK:
  1. Doe Aanvraag - Stuur een aanvraag naar het eindpunt
  2. Betaling Vereist - Server reageert met betalingsvereisten (402 status)
  3. Auto-Betaling - SDK maakt en verstuurt automatisch de betaling
  4. Ontvang Respons - Ontvang je API-respons

​
Aan de Slag

Installeer de x402 SDK voor je taal: 
# Node.js
npm install x402-fetch viem

# Python  
pip install x402 eth-account

​
Voorbeeldgebruik

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

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

// Doe een betaalde aanvraag - betaling is automatisch
const response = await fetchWithPayment("https://api.olostep.com/x402/v1/maps", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({ /* your data */ })
});

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

​
Meer Leren

Aangedreven door Orthogonal