メインコンテンツへスキップ
POST
/
browser
ブラウザセッションを作成
curl --request POST \
  --url https://api.firecrawl.dev/v2/browser \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "ttl": 300,
  "activityTtl": 1805,
  "streamWebView": true
}
'
{
  "success": true,
  "id": "<string>",
  "cdpUrl": "<string>",
  "liveViewUrl": "<string>",
  "expiresAt": "2023-11-07T05:31:56Z"
}

​
ヘッダー

ヘッダー値
AuthorizationBearer <API_KEY>
Content-Typeapplication/json

​
リクエストボディ

ParameterTypeRequiredDefaultDescription
ttlnumberNo300セッション全体の有効期間（秒）（30〜3600）
activityTtlnumberNo60セッションが破棄されるまでの非アクティブ状態の継続時間（秒）（10〜3600）

​
レスポンス

フィールド型説明
successbooleanセッションが作成されたかどうか
idstringセッションの一意の識別子
cdpUrlstringCDP 接続用の WebSocket URL
liveViewUrlstringセッションをリアルタイムで閲覧するための URL
expiresAtstringTTL に基づいてセッションの有効期限が切れる時刻

​
リクエストの例

curl -X POST "https://api.firecrawl.dev/v2/browser" \
  -H "Authorization: Bearer $FIRECRAWL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "ttl": 120
  }'

​
レスポンス例

{
  "success": true,
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "cdpUrl": "wss://cdp-proxy.firecrawl.dev/cdp/550e8400-e29b-41d4-a716-446655440000",
  "liveViewUrl": "https://liveview.firecrawl.dev/550e8400-e29b-41d4-a716-446655440000"
}

承認

​
Authorization
string
header
必須

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

ボディ

application/json
​
ttl
integer
デフォルト:300

ブラウザセッションの総有効期間（秒）

必須範囲: 30 <= x <= 3600
​
activityTtl
integer

非アクティブ状態によりセッションが破棄されるまでの時間（秒）

必須範囲: 10 <= x <= 3600
​
streamWebView
boolean
デフォルト:true

ブラウザのライブビューをストリーミングするかどうか

レスポンス

ブラウザセッションが正常に作成されました

​
success
boolean
​
id
string

一意のセッション識別子

​
cdpUrl
string

Chrome DevTools Protocol にアクセスするための WebSocket URL

​
liveViewUrl
string

ブラウザーセッションをリアルタイムで表示するための URL

​
expiresAt
string<date-time>

TTL に基づくセッションの有効期限