Skip to main content
POST
クエリに対する本格的なリサーチ処理を開始する
Deep Research エンドポイントは、あらゆるトピックに対する AI 主導の高度なリサーチと分析を行えます。リサーチクエリを入力するだけで、Firecrawl が自律的にウェブを探索し、関連情報を収集して、知見を統合した包括的なインサイトにまとめます。
これはレガシーな v1 Deep Research API です。新しいリサーチエージェントには、Search と Scrape を基に構築された、現在の Deep Research use case を使用してください。
ステータスのエンドポイントをお探しですか?Deep Research Status エンドポイントをご確認ください。

レスポンス構造

レスポンスには次が含まれます:
  • activities: 以下を含むリサーチ活動の一覧:
    • type: 活動タイプ (‘search’, ‘extract’, ‘analyze’, ‘reasoning’, ‘synthesis’, ‘thought’)
    • status: ステータス (‘processing’, ‘complete’, ‘error’)
    • message: 活動/発見の説明
    • timestamp: ISO タイムスタンプ
    • depth: リサーチ深度レベル
  • sources: 参照した URL (以下を含む) :
    • title: ソースのタイトル
    • description: ソースの説明
    • url: ソースの URL
    • icon: ソースのファビコン
  • finalAnalysis: 包括的な分析 (完了時)
  • status: 全体のステータス (‘processing’, ‘completed’, ‘failed’)
  • currentDepth: 現在のリサーチ深度
  • maxDepth: 最大リサーチ深度
  • totalUrls: 分析した URL の数
  • expiresAt: 結果の有効期限となる ISO タイムスタンプ

制限事項

  1. 公開情報が得られるトピックに最適
  2. リサーチは最大10分まで
  3. 重要な情報は手動での検証を推奨
  4. アルファ版機能 — 手法や出力は変更される可能性があります

料金

料金は解析対象となる URL の数に基づきます:
  • URL 1 件ごとに 1 クレジット
  • maxUrls パラメーターで使用数を制御できます

Authorizations

Authorization
string
header
required

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

Body

application/json
query
string
required

調査するクエリ

analysisPrompt
string

最終的な分析に使用するプロンプトです。最終的な分析結果の Markdown を特定の形式で整形するために使用します。

formats
enum<string>[]
Available options:
markdown,
json
jsonOptions
object

JSON 出力オプション

maxDepth
integer
default:7

リサーチ反復の最大深さ

Required range: 1 <= x <= 12
maxUrls
integer
default:20

分析する URL の最大数

Required range: 1 <= x <= 1000
systemPrompt
string

リサーチエージェントに使用するシステムプロンプトです。エージェントの振る舞いを特定の方向に導きたい場合に役立ちます。

timeLimit
integer
default:300

制限時間(秒)

Required range: 30 <= x <= 600

Response

リサーチジョブの開始に成功しました

id
string<uuid>

リサーチジョブの ID

success
boolean
Example:

true