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

<!-- agent-signals: reading_time_min: 3 · est_tokens: 1529 · updated: 2026-07-30 -->

El punto de conexión Deep Research permite realizar investigación y análisis profundos con IA sobre cualquier tema. Solo tienes que proporcionar una consulta de investigación y Firecrawl explorará la web de forma autónoma, reunirá información relevante y sintetizará los hallazgos en conocimientos integrales.

<Warning>
  Esta es la API heredada de Deep Research v1. Para los nuevos agentes de investigación, usa el [caso de uso de Deep Research](/es/use-cases/deep-research) actual, que está construido a partir de Search y Scrape.
</Warning>

¿Buscas el punto de conexión de estado? Consulta el punto de conexión [Deep Research Status](/es/api-reference/v1-endpoint/deep-research-get).

<div id="response-structure">
  ### Estructura de la respuesta [#estructura-de-la-respuesta]
</div>

La respuesta incluye:

* **activities**: Lista de actividades de investigación con:
  * `type`: Tipo de actividad ('search', 'extract', 'analyze', 'reasoning', 'synthesis', 'thought')
  * `status`: Estado ('processing', 'complete', 'error')
  * `message`: Descripción de la actividad o hallazgo
  * `timestamp`: Marca de tiempo ISO
  * `depth`: Nivel de profundidad de la investigación

* **sources**: URLs de referencia con:
  * `title`: Título de la fuente
  * `description`: Descripción de la fuente
  * `url`: URL de la fuente
  * `icon`: Favicon de la fuente

* **finalAnalysis**: Análisis completo (cuando se haya completado)

* **status**: Estado general ('processing', 'completed', 'failed')

* **currentDepth**: Profundidad de investigación actual

* **maxDepth**: Profundidad máxima de la investigación

* **totalUrls**: Número de URLs analizadas

* **expiresAt**: Marca de tiempo ISO de expiración de los resultados

<div id="limitations">
  ### Limitaciones [#limitaciones]
</div>

1. Ideal para temas con información pública disponible
2. Tareas de investigación limitadas a un máximo de 10 minutos
3. Se recomienda la verificación manual para información crítica
4. Función en alfa: la metodología y los resultados pueden evolucionar

<div id="billing">
  ### Facturación [#facturación]
</div>

La facturación se basa en el número de URL analizadas:

* Cada URL = 1 crédito
* Controla el uso con el parámetro `maxUrls`

`POST /deep-research`

Iniciar una operación de investigación profunda sobre una consulta

## OpenAPI

```json
{
  "security": [
    {
      "bearerAuth": []
    }
  ],
  "requestBody": {
    "content": {
      "application/json": {
        "schema": {
          "properties": {
            "analysisPrompt": {
              "description": "El prompt que se utilizará para el análisis final. Útil para formatear el markdown del análisis final de una forma específica.",
              "type": "string"
            },
            "formats": {
              "default": [
                "markdown"
              ],
              "items": {
                "enum": [
                  "markdown",
                  "json"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "jsonOptions": {
              "description": "Opciones de salida JSON",
              "properties": {
                "prompt": {
                  "description": "El prompt que se usará para la salida en formato JSON",
                  "type": "string"
                },
                "schema": {
                  "description": "El esquema que se utilizará para la salida en formato JSON. Debe ajustarse a [JSON Schema](https://json-schema.org/).",
                  "type": "object"
                },
                "systemPrompt": {
                  "description": "El prompt del sistema que se debe usar para la salida en formato JSON",
                  "type": "string"
                }
              },
              "type": "object"
            },
            "maxDepth": {
              "default": 7,
              "description": "Profundidad máxima de iteraciones de investigación",
              "maximum": 12,
              "minimum": 1,
              "type": "integer"
            },
            "maxUrls": {
              "default": 20,
              "description": "Número máximo de URL a analizar",
              "maximum": 1000,
              "minimum": 1,
              "type": "integer"
            },
            "query": {
              "description": "Consulta para investigar",
              "type": "string"
            },
            "systemPrompt": {
              "description": "El prompt de sistema que se usará para el agente de investigación. Útil para orientar al agente de investigación en una dirección concreta.",
              "type": "string"
            },
            "timeLimit": {
              "default": 300,
              "description": "Límite de tiempo en segundos",
              "maximum": 600,
              "minimum": 30,
              "type": "integer"
            }
          },
          "required": [
            "query"
          ],
          "type": "object"
        }
      }
    },
    "required": true
  },
  "responses": {
    "200": {
      "content": {
        "application/json": {
          "schema": {
            "properties": {
              "id": {
                "description": "ID de la tarea de investigación",
                "format": "uuid",
                "type": "string"
              },
              "success": {
                "example": true,
                "type": "boolean"
              }
            },
            "type": "object"
          }
        }
      },
      "description": "Tarea de investigación iniciada correctamente"
    },
    "400": {
      "content": {
        "application/json": {
          "schema": {
            "properties": {
              "error": {
                "example": "Invalid parameters provided",
                "type": "string"
              },
              "success": {
                "example": false,
                "type": "boolean"
              }
            },
            "type": "object"
          }
        }
      },
      "description": "Parámetros de solicitud no válidos"
    }
  }
}
```