ドキュメント › はじめに › クイックスタート

クイックスタート

2分以内で最初のデータ収集まで完了します。

前提条件

ステップ 1: APIキーの取得

ダッシュボードにサインインし、APIキーを作成します。次のような形式です: pk_live_a1b2c3d4e5f6...

コピーしてください。すべてのリクエストで必要になります。

ステップ 2: 最初のリクエストの送信

ターミナルを開いて以下を実行します (YOUR_API_KEY を実際のキーに置き換えてください):

curl -X POST https://eu.api.foura.ai/api/single/ \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"method": "GET", "url": "https://example.com"}'

これにより example.com へHTTPリクエストが送信され、ページのHTMLが返されます。

ステップ 3: レスポンスの確認

{
  "status": 200,
  "headers": [
    {
      "result": { "version": "HTTP/2", "code": 200, "reason": "" },
      "content-type": "text/html; charset=UTF-8",
      "content-length": "1256"
    }
  ],
  "data": "<!doctype html><html>...</html>",
  "total_time": 0.45
}

headers フィールドはオブジェクトの配列で、リダイレクトのホップごとに1つ作成されます。各エントリには result フィールドがあり、ステータスラインと、そのホップでターゲットが返したすべてのレスポンスヘッダーが含まれます。

主要なフィールド:

  • status: ターゲットサイトのHTTPステータスコード
  • data: レスポンスの本文 (HTML、JSON、またはプレーンテキスト)
  • total_time: 秒単位でのリクエストの所要時間

ステップ 4: 異なるエンドポイントを試す

FourAには、状況に合わせて4つのエンドポイントが用意されています:

エンドポイント 速度 ユースケース
POST /api/auto/ 変動 (ウォームホストでは高速) サイトが必要とするエンジンが不明な場合。URLを渡すと、FourAが動作する最も安価なパスを選択します。
POST /api/single/ 最速 (200ms-2s) 静的ページ、API、サーバーレンダリングサイト
POST /api/browser/ 中程度 (2s-10s) JavaScriptを多用するページ、SPA、動的コンテンツ
POST /api/proxy/ 高速 (1s-5s) ボット検知のあるサイト、地域制限のあるコンテンツ

autoリクエストを試す (スマートなデフォルト):

curl -X POST https://eu.api.foura.ai/api/auto/ \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com/product/42",
    "validate": {"data": {"accept": ["Add to cart"]}}
  }'

browserリクエストを試す:

curl -X POST https://eu.api.foura.ai/api/browser/ \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com", "timeout_ms": 15000}'

proxyリクエストを試す (自動プロキシローテーション):

curl -X POST https://eu.api.foura.ai/api/proxy/ \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "maxTries": 3,
    "request": {
      "method": "GET",
      "url": "https://example.com",
      "unblocker": true
    }
  }'

次のステップ

最終更新日: 2026年7月1日
認証 →