Deep Research

1 min read

get/deep-research/{id}

Request example

curl --request GET \
  --url https://api.firecrawl.dev/v1/deep-research/{id} \
  --header 'Authorization: Bearer <token>'

Response

{
  "success": true,
  "data": {
    "finalAnalysis": "<string>",
    "json": {},
    "activities": [
      {
        "type": "<string>",
        "status": "<string>",
        "message": "<string>",
        "timestamp": "2026-08-10T12:00:00Z",
        "depth": 1
      }
    ],
    "sources": [
      {
        "url": "<string>",
        "title": "<string>",
        "description": "<string>",
        "favicon": "<string>"
      }
    ],
    "status": "processing",
    "error": "<string>",
    "expiresAt": "2026-08-10T12:00:00Z",
    "currentDepth": 1,
    "maxDepth": 1,
    "totalUrls": 1
  }
}

get/deep-research/{id}

Authorization

Authorizationstringheaderrequired#

Bearer authentication header of the form Bearer <token>, where <token> is your API key.

Path parameters

idstringrequired#

The ID of the research job

Responses

application/json

Successful response

successboolean#

dataobject#

Show child attributes

finalAnalysisstring#

jsonobject#

Displayed when using JSON format

activitiesobject[]#

Show child attributes

typestring#

statusstring#

messagestring#

timestampstring#

depthinteger#

sourcesobject[]#

Show child attributes

urlstring#

titlestring · string[]#

Title extracted from the page, can be a string or array of strings

Show child attributes

One of

descriptionstring · string[]#

Description extracted from the page, can be a string or array of strings

Show child attributes

One of

faviconstring#

statusenum<string>#

Options:processingcompletedfailed

errorstring#

expiresAtstring#

currentDepthinteger#

maxDepthinteger#

totalUrlsinteger#