タスクの作成

このガイドでは、FourA Dashboard を使用して API キーを作成し、最初のリクエストを送信する手順を説明します。

ステップ 1: Dashboard を開く

Dashboard にアクセスし、FourA アカウントでサインインします。

ステップ 2: API キーを作成する

API Keys ページに移動し、Create API key をクリックします。キーを作成した後は、リストの上のボタンが Create Key に変わります。

キーにわかりやすい名前(例: "production-scraper"、"dev-testing")を付けます。API Key Created ダイアログに平文のキーとコピー用ボタンが表示され、Test your first request の下には実行可能な cURL コマンドと Copy command が表示されます。スマートフォンやタブレットでは、代わりに Try it in the Playground からアクセスできます。

見逃した場合は、後からキーの行にある目のアイコンをクリックして再表示できます。表示機能がリリースされる前に作成されたレガシーキーは再表示できません。移行するには一度再生成してください。詳細な手順: Managing API Keys。

キーの形式は次のようになります: pk_live_a1b2c3d4e5f6...

ステップ 3: エンドポイントを選択する

FourA には、さまざまなシナリオに対応する 4 つのエンドポイントがあります:

Auto (POST /api/auto/)

スマートなデフォルト設定です。URL を渡し(validate ルールと組み合わせるのが理想的です)、FourA はローテーション proxy から proxy 経由のフルブラウザまで順次試行し、合格した最初の応答で停止します。最初にダイレクトな request を試行させるには forceProxy: false を設定します。新しいサイトを対象としており、必要な設定がまだ分からない場合に最適です。

Single (POST /api/single/)

高速な HTTP request を送信します。静的な HTML ページや API endpoint に最適です。応答時間: 通常 2 秒未満。

Browser (POST /api/browser/)

Chrome ブラウザインスタンスを実行して JavaScript をレンダリングします。SPA、遅延読み込みコンテンツ、JS の実行が必要なページに最適です。応答時間: 2 から 10 秒。

Proxy (POST /api/proxy/)

自動リトライ機能を備えたローテーション proxy 経由で request をルーティングします。リクエスト元を検査するサイトや、国ごとに異なる応答を返すサイトに最適です。

ステップ 4: 最初のリクエストを送信する

ターミナルを開き、以下を実行します:

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"}'

ステップ 5: response の確認

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

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

主要フィールド:

  • status: ターゲットサイトからの HTTP status code
  • data: response body (HTML、JSON、または未加工テキスト)
  • total_time: request 所要時間 (秒)

ステップ 6: ブラウザリクエストを試す

ターゲットページがコンテンツのレンダリングに JavaScript を使用している場合は、代わりに browser endpoint を使用します:

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/products", "timeout_ms": 15000}'

ブラウザの response では data ではなく body が使用されます:

{
  "status": 200,
  "headers": {"content-type": "text/html"},
  "body": "<html>...</html>"
}

よくある問題

問題 解決策
使用するエンジンが不明 auto endpoint から開始してください。最適なパスを選択し、成功した設定を記憶します。
コンテンツが空 single から browser endpoint に切り替えてください。ページに JS レンダリングが必要な可能性があります。
レスポンスに検証ページが表示される 自動 IP ローテーションを利用するため proxy endpoint に切り替えてください
タイムアウト timeout_ms を増やすか、URL が正しいことを確認してください
キーの紛失 API Keys 内の対象キーの行にある目のアイコンをクリックして表示するか、レガシーキーの場合は再生成してください

次のステップ

最終更新日: 2026年10月28日