# Deep Research (/ja/api-reference/v1-endpoint/deep-research)

<!-- agent-signals: reading_time_min: 2 · est_tokens: 1185 · updated: 2026-07-30 -->

Deep Research エンドポイントは、あらゆるトピックに対する AI 主導の高度なリサーチと分析を行えます。リサーチクエリを入力するだけで、Firecrawl が自律的にウェブを探索し、関連情報を収集して、知見を統合した包括的なインサイトにまとめます。

<Warning>
  これはレガシーな v1 Deep Research API です。新しいリサーチエージェントには、Search と Scrape を基に構築された、現在の [Deep Research use case](/ja/use-cases/deep-research) を使用してください。
</Warning>

ステータスのエンドポイントをお探しですか？[Deep Research Status](/ja/api-reference/v1-endpoint/deep-research-get) エンドポイントをご確認ください。

<div id="response-structure">
  ### レスポンス構造 [#レスポンス構造]
</div>

レスポンスには次が含まれます:

* **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 タイムスタンプ

<div id="limitations">
  ### 制限事項 [#制限事項]
</div>

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

<div id="billing">
  ### 料金 [#料金]
</div>

料金は解析対象となる URL の数に基づきます：

* URL 1 件ごとに 1 クレジット
* `maxUrls` パラメーターで使用数を制御できます

`POST /deep-research`

クエリに対する本格的なリサーチ処理を開始する

## OpenAPI

```json
{
  "security": [
    {
      "bearerAuth": []
    }
  ],
  "requestBody": {
    "content": {
      "application/json": {
        "schema": {
          "properties": {
            "analysisPrompt": {
              "description": "最終的な分析に使用するプロンプトです。最終的な分析結果の Markdown を特定の形式で整形するために使用します。",
              "type": "string"
            },
            "formats": {
              "default": [
                "markdown"
              ],
              "items": {
                "enum": [
                  "markdown",
                  "json"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "jsonOptions": {
              "description": "JSON 出力オプション",
              "properties": {
                "prompt": {
                  "description": "JSON出力用のプロンプト",
                  "type": "string"
                },
                "schema": {
                  "description": "JSON 出力で使用するスキーマ。[JSON Schema](https://json-schema.org/) に準拠している必要があります。",
                  "type": "object"
                },
                "systemPrompt": {
                  "description": "JSON 出力用のシステムプロンプト",
                  "type": "string"
                }
              },
              "type": "object"
            },
            "maxDepth": {
              "default": 7,
              "description": "リサーチ反復の最大深さ",
              "maximum": 12,
              "minimum": 1,
              "type": "integer"
            },
            "maxUrls": {
              "default": 20,
              "description": "分析する URL の最大数",
              "maximum": 1000,
              "minimum": 1,
              "type": "integer"
            },
            "query": {
              "description": "調査するクエリ",
              "type": "string"
            },
            "systemPrompt": {
              "description": "リサーチエージェントに使用するシステムプロンプトです。エージェントの振る舞いを特定の方向に導きたい場合に役立ちます。",
              "type": "string"
            },
            "timeLimit": {
              "default": 300,
              "description": "制限時間（秒）",
              "maximum": 600,
              "minimum": 30,
              "type": "integer"
            }
          },
          "required": [
            "query"
          ],
          "type": "object"
        }
      }
    },
    "required": true
  },
  "responses": {
    "200": {
      "content": {
        "application/json": {
          "schema": {
            "properties": {
              "id": {
                "description": "リサーチジョブの ID",
                "format": "uuid",
                "type": "string"
              },
              "success": {
                "example": true,
                "type": "boolean"
              }
            },
            "type": "object"
          }
        }
      },
      "description": "リサーチジョブの開始に成功しました"
    },
    "400": {
      "content": {
        "application/json": {
          "schema": {
            "properties": {
              "error": {
                "example": "Invalid parameters provided",
                "type": "string"
              },
              "success": {
                "example": false,
                "type": "boolean"
              }
            },
            "type": "object"
          }
        }
      },
      "description": "無効なリクエストパラメータです"
    }
  }
}
```