メインコンテンツへスキップ

​
概要

Olostep APIエンドポイントをステーブルコインを使用した従量課金で利用できるようになりました。 これらのエンドポイントはx402支払いプロトコルを使用しており、ステーブルコインでの従量課金アクセスを可能にします。各リクエストには認証と支払いのための支払いヘッダーが必要です。
従量課金エンドポイント以下にリストされているすべてのエンドポイントは、x402プロトコルを介してステーブルコインでの支払いを受け付けます。サブスクリプションは不要で、使用した分だけ支払います。

​
認証

リクエストに支払いヘッダーを含めてください： 
X-Payment: {{paymentHeader}}
支払いは自動的に処理され、リクエストが完了する前に確認されます。

​
Olostep API

​
支払い対応エンドポイント

​
POST /v1/maps

このエンドポイントでは、特定のウェブサイト上のすべてのURLを取得できます。複雑なウェブサイトの場合、最大120秒かかることがあります。大規模なウェブサイトの場合、結果はカーソルベースのページネーションを使用してページ分けされます。 価格: リクエストごとに$0.01 ネットワーク: 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

ウェブページのスクレイピングを開始します。 価格: リクエストごとに$0.01 ネットワーク: 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

新しいクロールを開始します。進行状況を追跡するためのidを受け取ります。操作はサイトと深さ、ページのパラメータに応じて1〜10分かかる場合があります。 価格: 動的 - 使用量に基づいてリクエストごとに計算
このエンドポイントは動的価格を使用します。実際のコストはリクエストパラメータによって決定され、処理前に402 Payment Requiredレスポンスで表示されます。
ネットワーク: 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

AIは、提供されたタスクに対する回答を見つけるために検索やウェブページの閲覧などのアクションを実行します。実行時間は複雑さに応じて3〜30秒です。長いタスクの場合は、エージェントエンドポイントを使用してください。 価格: リクエストごとに$0.05 ネットワーク: 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": ""
  }'

​
標準エンドポイント

これらのエンドポイントは支払いを必要としません：
  • GET /v1/crawls/{crawl_id} - 特定のクロールに関する情報を取得します。
  • GET /v1/batches/{batch_id}/items - バッチで処理されたアイテムのリストを取得します。その後、Retrieve Endpointを使用してコンテンツを取得できます。
  • GET /v1/crawls/{crawl_id}/pages - 特定のクロールのページリストを取得します。
  • GET /v1/batches/{batch_id} - バッチのステータスと進行状況情報を取得します。バッチのコンテンツを取得するには、こちらを参照してください。
  • GET /v1/answers/{answer_id} - このエンドポイントは、IDによって以前に完了した回答を取得します。
  • GET /v1/scrapes/{scrape_id} - スクレイプのレスポンスを取得するために使用できます。
  • GET /v1/retrieve - 処理されたバッチとクロールのURLのページコンテンツを取得します。

​
x402の仕組み

支払いフローはx402 SDKによって自動的に処理されます：
  1. リクエストを送信 - エンドポイントにリクエストを送信
  2. 支払いが必要 - サーバーが支払い要件（402ステータス）で応答
  3. 自動支払い - SDKが自動的に支払いを作成し送信
  4. レスポンスを取得 - APIレスポンスを受け取る

​
はじめに

使用する言語のx402 SDKをインストールしてください： 
# Node.js
npm install x402-fetch viem

# Python  
pip install x402 eth-account

​
使用例

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

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

// 有料リクエストを行う - 支払いは自動
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);

​
詳しく学ぶ

Powered by Orthogonal