Deep Research

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

curl --request POST \
  --url https://api.firecrawl.dev/v1/deep-research \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "query": "<string>",
  "analysisPrompt": "<string>",
  "formats": [
    "markdown"
  ],
  "jsonOptions": {
    "prompt": "<string>",
    "schema": {},
    "systemPrompt": "<string>"
  },
  "maxDepth": 7,
  "maxUrls": 20,
  "systemPrompt": "<string>",
  "timeLimit": 300
}
'

import requests

url = "https://api.firecrawl.dev/v1/deep-research"

payload = {
    "query": "<string>",
    "analysisPrompt": "<string>",
    "formats": ["markdown"],
    "jsonOptions": {
        "prompt": "<string>",
        "schema": {},
        "systemPrompt": "<string>"
    },
    "maxDepth": 7,
    "maxUrls": 20,
    "systemPrompt": "<string>",
    "timeLimit": 300
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    query: '<string>',
    analysisPrompt: '<string>',
    formats: ['markdown'],
    jsonOptions: {prompt: '<string>', schema: {}, systemPrompt: '<string>'},
    maxDepth: 7,
    maxUrls: 20,
    systemPrompt: '<string>',
    timeLimit: 300
  })
};

fetch('https://api.firecrawl.dev/v1/deep-research', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.firecrawl.dev/v1/deep-research",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'query' => '<string>',
    'analysisPrompt' => '<string>',
    'formats' => [
        'markdown'
    ],
    'jsonOptions' => [
        'prompt' => '<string>',
        'schema' => [
                
        ],
        'systemPrompt' => '<string>'
    ],
    'maxDepth' => 7,
    'maxUrls' => 20,
    'systemPrompt' => '<string>',
    'timeLimit' => 300
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.firecrawl.dev/v1/deep-research"

	payload := strings.NewReader("{\n  \"query\": \"<string>\",\n  \"analysisPrompt\": \"<string>\",\n  \"formats\": [\n    \"markdown\"\n  ],\n  \"jsonOptions\": {\n    \"prompt\": \"<string>\",\n    \"schema\": {},\n    \"systemPrompt\": \"<string>\"\n  },\n  \"maxDepth\": 7,\n  \"maxUrls\": 20,\n  \"systemPrompt\": \"<string>\",\n  \"timeLimit\": 300\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.firecrawl.dev/v1/deep-research")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"query\": \"<string>\",\n  \"analysisPrompt\": \"<string>\",\n  \"formats\": [\n    \"markdown\"\n  ],\n  \"jsonOptions\": {\n    \"prompt\": \"<string>\",\n    \"schema\": {},\n    \"systemPrompt\": \"<string>\"\n  },\n  \"maxDepth\": 7,\n  \"maxUrls\": 20,\n  \"systemPrompt\": \"<string>\",\n  \"timeLimit\": 300\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.firecrawl.dev/v1/deep-research")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"query\": \"<string>\",\n  \"analysisPrompt\": \"<string>\",\n  \"formats\": [\n    \"markdown\"\n  ],\n  \"jsonOptions\": {\n    \"prompt\": \"<string>\",\n    \"schema\": {},\n    \"systemPrompt\": \"<string>\"\n  },\n  \"maxDepth\": 7,\n  \"maxUrls\": 20,\n  \"systemPrompt\": \"<string>\",\n  \"timeLimit\": 300\n}"

response = http.request(request)
puts response.read_body

{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "success": true
}

{
  "error": "Invalid parameters provided",
  "success": false
}

POST

deep-research

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

curl --request POST \
  --url https://api.firecrawl.dev/v1/deep-research \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "query": "<string>",
  "analysisPrompt": "<string>",
  "formats": [
    "markdown"
  ],
  "jsonOptions": {
    "prompt": "<string>",
    "schema": {},
    "systemPrompt": "<string>"
  },
  "maxDepth": 7,
  "maxUrls": 20,
  "systemPrompt": "<string>",
  "timeLimit": 300
}
'

import requests

url = "https://api.firecrawl.dev/v1/deep-research"

payload = {
    "query": "<string>",
    "analysisPrompt": "<string>",
    "formats": ["markdown"],
    "jsonOptions": {
        "prompt": "<string>",
        "schema": {},
        "systemPrompt": "<string>"
    },
    "maxDepth": 7,
    "maxUrls": 20,
    "systemPrompt": "<string>",
    "timeLimit": 300
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    query: '<string>',
    analysisPrompt: '<string>',
    formats: ['markdown'],
    jsonOptions: {prompt: '<string>', schema: {}, systemPrompt: '<string>'},
    maxDepth: 7,
    maxUrls: 20,
    systemPrompt: '<string>',
    timeLimit: 300
  })
};

fetch('https://api.firecrawl.dev/v1/deep-research', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.firecrawl.dev/v1/deep-research",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'query' => '<string>',
    'analysisPrompt' => '<string>',
    'formats' => [
        'markdown'
    ],
    'jsonOptions' => [
        'prompt' => '<string>',
        'schema' => [
                
        ],
        'systemPrompt' => '<string>'
    ],
    'maxDepth' => 7,
    'maxUrls' => 20,
    'systemPrompt' => '<string>',
    'timeLimit' => 300
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.firecrawl.dev/v1/deep-research"

	payload := strings.NewReader("{\n  \"query\": \"<string>\",\n  \"analysisPrompt\": \"<string>\",\n  \"formats\": [\n    \"markdown\"\n  ],\n  \"jsonOptions\": {\n    \"prompt\": \"<string>\",\n    \"schema\": {},\n    \"systemPrompt\": \"<string>\"\n  },\n  \"maxDepth\": 7,\n  \"maxUrls\": 20,\n  \"systemPrompt\": \"<string>\",\n  \"timeLimit\": 300\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.firecrawl.dev/v1/deep-research")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"query\": \"<string>\",\n  \"analysisPrompt\": \"<string>\",\n  \"formats\": [\n    \"markdown\"\n  ],\n  \"jsonOptions\": {\n    \"prompt\": \"<string>\",\n    \"schema\": {},\n    \"systemPrompt\": \"<string>\"\n  },\n  \"maxDepth\": 7,\n  \"maxUrls\": 20,\n  \"systemPrompt\": \"<string>\",\n  \"timeLimit\": 300\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.firecrawl.dev/v1/deep-research")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"query\": \"<string>\",\n  \"analysisPrompt\": \"<string>\",\n  \"formats\": [\n    \"markdown\"\n  ],\n  \"jsonOptions\": {\n    \"prompt\": \"<string>\",\n    \"schema\": {},\n    \"systemPrompt\": \"<string>\"\n  },\n  \"maxDepth\": 7,\n  \"maxUrls\": 20,\n  \"systemPrompt\": \"<string>\",\n  \"timeLimit\": 300\n}"

response = http.request(request)
puts response.read_body

{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "success": true
}

{
  "error": "Invalid parameters provided",
  "success": false
}

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.

Esta es la API heredada de Deep Research v1. Para los nuevos agentes de investigación, usa el caso de uso de Deep Research actual, que está construido a partir de Search y Scrape.

¿Buscas el punto de conexión de estado? Consulta el punto de conexión Deep Research Status.

Estructura de la respuesta

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

Limitaciones

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

Facturación

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

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

Consulta para investigar

analysisPrompt

string

El prompt que se utilizará para el análisis final. Útil para formatear el markdown del análisis final de una forma específica.

formats

enum<string>[]

Available options:

markdown,

json

jsonOptions

object

Opciones de salida JSON

Show child attributes

maxDepth

integer

default:7

Profundidad máxima de iteraciones de investigación

Required range: 1 <= x <= 12

maxUrls

integer

default:20

Número máximo de URL a analizar

Required range: 1 <= x <= 1000

systemPrompt

string

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.

timeLimit

integer

default:300

Límite de tiempo en segundos

Required range: 30 <= x <= 600

Response

Tarea de investigación iniciada correctamente

string<uuid>

ID de la tarea de investigación

success

boolean

Example:

true

Get Started

Core Endpoints

More

Quickstarts

Developer Guides

Webhooks

Use Cases

Other

Contributing

Estructura de la respuesta

Limitaciones

Facturación

Authorizations

Body

Response

​Estructura de la respuesta

​Limitaciones

​Facturación

Authorizations

Body

Response

Estructura de la respuesta

Limitaciones

Facturación