クイックスタートガイド
2分未満で、ゼロから最初のデータ収集を開始できます。
前提条件
ステップ 1: API キーの取得
Dashboard にサインインし、API キーを作成します。キーは pk_live_a1b2c3d4e5f6... のようになります。
コピーしてください。すべての request に必要になります。
ステップ 2: 最初の request の実行
ターミナルを開き、以下を実行します(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 request が送信され、ページの HTML が返されます。
ステップ 3: response の確認
{
"status": 200,
"headers": [["content-type", "text/html"]],
"data": "<!doctype html><html>...</html>",
"total_time": 0.45
}
主なフィールド:
status: ターゲットサイトからの HTTP ステータスコードdata: response body(HTML、JSON、または生のテキスト)total_time: 秒単位での request 所要時間
ステップ 4: 異なる endpoint の試行
FourA には、異なる状況に対応する3つの endpoint があります。
| Endpoint | 速度 | 使用例 |
|---|---|---|
POST /api/single/ |
最速 (200ms-2s) | 静的ページ、API、サーバーレンダリングサイト |
POST /api/browser/ |
中速 (2s-10s) | JavaScriptを多用するページ、SPA、動的コンテンツ |
POST /api/proxy/ |
高速 (1s-5s) | ボット検知のあるサイト、地域制限のあるコンテンツ |
browser request を試す:
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 request を試す(自動 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
}
}'
次のステップ
- 認証: API キーの管理とセキュリティ
- API Endpoints: 3つの endpoint すべての完全なパラメータリファレンス
- SDK とライブラリ: Python、Node.js、Go、Ruby の例
- 適切な Endpoint の選択: single、browser、proxy の使い分け