Deep Research

Lancer une recherche approfondie pour une requête

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

Lancer une recherche approfondie pour une requête

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
}

Le point de terminaison Deep Research permet d’effectuer des recherches et des analyses approfondies par IA sur n’importe quel sujet. Il suffit de fournir une requête de recherche, et Firecrawl explorera le web de façon autonome, collectera les informations pertinentes et synthétisera les résultats en insights complets.

Il s’agit de l’API Deep Research v1 héritée. Pour les nouveaux agents de recherche, utilisez le cas d’usage Deep Research actuel, construit à partir de Search et Scrape.

Vous cherchez le point de terminaison de statut ? Consultez Deep Research Status.

Structure de la réponse

La réponse comprend :

activities : Liste des activités de recherche avec :
- type : Type d’activité (« search », « extract », « analyze », « reasoning », « synthesis », « thought »)
- status : État (« processing », « complete », « error »)
- message : Description de l’activité ou de la découverte
- timestamp : Horodatage ISO
- depth : Niveau de profondeur de la recherche
sources : URL de référence avec :
- title : Titre de la source
- description : Description de la source
- url : URL de la source
- icon : Favicon de la source
finalAnalysis : Analyse complète (une fois terminée)
status : État global (« processing », « completed », « failed »)
currentDepth : Profondeur de recherche actuelle
maxDepth : Profondeur de recherche maximale
totalUrls : Nombre d’URL analysées
expiresAt : Horodatage ISO d’expiration des résultats

Limitations

Idéal pour des sujets dont les informations sont publiquement disponibles
Tâches de recherche limitées à 10 minutes maximum
Vérification manuelle recommandée pour les informations critiques
Fonctionnalité en alpha — la méthodologie et les résultats peuvent évoluer

Facturation

La facturation dépend du nombre d’URL analysées :

Chaque URL = 1 crédit
Gérez votre utilisation avec le paramètre 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

La requête à étudier

analysisPrompt

string

Le prompt à utiliser pour l’analyse finale. Utile pour formater le markdown de l’analyse finale d’une manière spécifique.

formats

enum<string>[]

Available options:

markdown,

json

jsonOptions

object

Options de sortie au format JSON

Show child attributes

maxDepth

integer

default:7

Profondeur maximale des itérations de recherche

Required range: 1 <= x <= 12

maxUrls

integer

default:20

Nombre maximal d’URL à analyser

Required range: 1 <= x <= 1000

systemPrompt

string

L’invite système à utiliser pour l’agent de recherche. Permet d’orienter l’agent de recherche dans une direction précise.

timeLimit

integer

default:300

Limite de temps (en secondes)

Required range: 30 <= x <= 600

Response

La tâche de recherche a bien démarré

string<uuid>

ID de la tâche de recherche

success

boolean

Example:

true

Get Started

Core Endpoints

More

Quickstarts

Developer Guides

Webhooks

Use Cases

Other

Contributing

Structure de la réponse

Limitations

Facturation

Authorizations

Body

Response

​Structure de la réponse

​Limitations

​Facturation

Authorizations

Body

Response

Structure de la réponse

Limitations

Facturation