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

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

O endpoint Deep Research possibilita pesquisa e análise aprofundadas com IA sobre qualquer tema. Basta fornecer uma consulta de pesquisa e o Firecrawl explorará a web de forma autônoma, reunirá informações relevantes e sintetizará os achados em insights abrangentes.

<Warning>
  Esta é a API legada v1 do Deep Research. Para novos agentes de pesquisa, use o [caso de uso atual de Deep Research](/pt-BR/use-cases/deep-research), que é construído a partir de Search e Scrape.
</Warning>

Procurando o endpoint de status? Confira o endpoint [Deep Research Status](/pt-BR/api-reference/v1-endpoint/deep-research-get).

<div id="response-structure">
  ### Estrutura da resposta [#estrutura-da-resposta]
</div>

A resposta inclui:

* **activities**: Lista de atividades de pesquisa com:
  * `type`: Tipo de atividade ('search', 'extract', 'analyze', 'reasoning', 'synthesis', 'thought')
  * `status`: Status ('processing', 'complete', 'error')
  * `message`: Descrição da atividade/descoberta
  * `timestamp`: Carimbo de data e hora em formato ISO
  * `depth`: Nível de profundidade da pesquisa

* **sources**: URLs de referência com:
  * `title`: Título da fonte
  * `description`: Descrição da fonte
  * `url`: URL da fonte
  * `icon`: Favicon da fonte

* **finalAnalysis**: Análise abrangente (quando concluída)

* **status**: Status geral ('processing', 'completed', 'failed')

* **currentDepth**: Profundidade de pesquisa atual

* **maxDepth**: Profundidade máxima de pesquisa

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

* **expiresAt**: Carimbo de data e hora ISO da expiração dos resultados

<div id="limitations">
  ### Limitações [#limitações]
</div>

1. Mais indicado para tópicos com informações de domínio público
2. Tarefas de pesquisa limitadas a, no máximo, 10 minutos
3. Recomenda-se verificação manual para informações críticas
4. Recurso em fase alfa — metodologia e resultados podem evoluir

<div id="billing">
  ### Cobrança [#cobrança]
</div>

A cobrança é baseada na quantidade de URLs analisadas:

* Cada URL = 1 crédito
* Controle o uso por meio do parâmetro `maxUrls`

`POST /deep-research`

Iniciar uma operação de pesquisa aprofundada com base em uma consulta

## OpenAPI

```json
{
  "security": [
    {
      "bearerAuth": []
    }
  ],
  "requestBody": {
    "content": {
      "application/json": {
        "schema": {
          "properties": {
            "analysisPrompt": {
              "description": "O prompt a ser usado na análise final. Útil para definir o formato do markdown da análise final de uma maneira específica.",
              "type": "string"
            },
            "formats": {
              "default": [
                "markdown"
              ],
              "items": {
                "enum": [
                  "markdown",
                  "json"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "jsonOptions": {
              "description": "Opções de saída em JSON",
              "properties": {
                "prompt": {
                  "description": "O prompt a ser usado para saída em JSON",
                  "type": "string"
                },
                "schema": {
                  "description": "O esquema a ser usado para a saída JSON. Deve estar em conformidade com o padrão [JSON Schema](https://json-schema.org/).",
                  "type": "object"
                },
                "systemPrompt": {
                  "description": "Prompt de sistema a ser usado para a saída JSON",
                  "type": "string"
                }
              },
              "type": "object"
            },
            "maxDepth": {
              "default": 7,
              "description": "Profundidade máxima de iterações de pesquisa",
              "maximum": 12,
              "minimum": 1,
              "type": "integer"
            },
            "maxUrls": {
              "default": 20,
              "description": "Número máximo de URLs para analisar",
              "maximum": 1000,
              "minimum": 1,
              "type": "integer"
            },
            "query": {
              "description": "Consulta de pesquisa",
              "type": "string"
            },
            "systemPrompt": {
              "description": "O prompt de sistema a ser usado pelo agente de pesquisa. Útil para orientar o agente de pesquisa em uma direção específica.",
              "type": "string"
            },
            "timeLimit": {
              "default": 300,
              "description": "Limite de tempo em segundos",
              "maximum": 600,
              "minimum": 30,
              "type": "integer"
            }
          },
          "required": [
            "query"
          ],
          "type": "object"
        }
      }
    },
    "required": true
  },
  "responses": {
    "200": {
      "content": {
        "application/json": {
          "schema": {
            "properties": {
              "id": {
                "description": "ID da tarefa de pesquisa",
                "format": "uuid",
                "type": "string"
              },
              "success": {
                "example": true,
                "type": "boolean"
              }
            },
            "type": "object"
          }
        }
      },
      "description": "Processo de pesquisa iniciado com sucesso"
    },
    "400": {
      "content": {
        "application/json": {
          "schema": {
            "properties": {
              "error": {
                "example": "Invalid parameters provided",
                "type": "string"
              },
              "success": {
                "example": false,
                "type": "boolean"
              }
            },
            "type": "object"
          }
        }
      },
      "description": "Parâmetros da requisição inválidos"
    }
  }
}
```