Research API that allows you to build deep research into your own applications”
This API is being deprecated in favor of our new Search API. For an example of how to build deep research, check out our open source Firesearch project. This API endpoint will still remain active but we will no longer be maintaining it after June 30, 2025.
The /deep-research
endpoint enables AI-powered deep research and analysis on any topic. Simply provide a research query, and Firecrawl will autonomously explore the web, gather relevant information, and synthesize findings into comprehensive insights.
Deep Research works by:
Firecrawl provides structured results that enable you to build powerful applications:
Key Parameters:
See API Reference for more details.
Deep Research jobs run asynchronously. You can monitor progress and receive real-time updates:
The data response includes:
type
: Type of activity (‘search’, ‘extract’, ‘analyze’, ‘reasoning’, ‘synthesis’, ‘thought’)status
: Activity status (‘processing’, ‘complete’, ‘error’)message
: Description of the activity or findingtimestamp
: ISO timestamp of when the activity occurreddepth
: Current research depth leveltitle
: Title of the sourcedescription
: Description of the sourceurl
: URL of the sourceicon
: Icon of the sourceYou can now specify the JSON output format by setting the formats
parameter to json
. Set the jsonOptions
parameter to specify the schema for the JSON output.
You can also specify a systemPrompt
and an analysisPrompt
to customize the agentic process and the final analysis, respectively.
While in Alpha we use a combination of small models to explore the web and synthesize information. That way we can keep the cost low and the research fast. But this can result in the synthesis not being very long and detailed.
Research Scope
Best suited for topics with publicly available information. May not access paywalled or private content.
Time Constraints
Research jobs are limited to 10 minutes maximum to ensure reasonable response times.
Source Verification
While sources are provided, manual verification of critical information is recommended.
Alpha State
As an Alpha feature, the research methodology and output format may evolve based on feedback.
Billing is done based on the number of urls
analyzed. Each url
is 1 credit. You can specify the max number of urls to analyze with the maxUrls
parameter.
Research API that allows you to build deep research into your own applications”
This API is being deprecated in favor of our new Search API. For an example of how to build deep research, check out our open source Firesearch project. This API endpoint will still remain active but we will no longer be maintaining it after June 30, 2025.
The /deep-research
endpoint enables AI-powered deep research and analysis on any topic. Simply provide a research query, and Firecrawl will autonomously explore the web, gather relevant information, and synthesize findings into comprehensive insights.
Deep Research works by:
Firecrawl provides structured results that enable you to build powerful applications:
Key Parameters:
See API Reference for more details.
Deep Research jobs run asynchronously. You can monitor progress and receive real-time updates:
The data response includes:
type
: Type of activity (‘search’, ‘extract’, ‘analyze’, ‘reasoning’, ‘synthesis’, ‘thought’)status
: Activity status (‘processing’, ‘complete’, ‘error’)message
: Description of the activity or findingtimestamp
: ISO timestamp of when the activity occurreddepth
: Current research depth leveltitle
: Title of the sourcedescription
: Description of the sourceurl
: URL of the sourceicon
: Icon of the sourceYou can now specify the JSON output format by setting the formats
parameter to json
. Set the jsonOptions
parameter to specify the schema for the JSON output.
You can also specify a systemPrompt
and an analysisPrompt
to customize the agentic process and the final analysis, respectively.
While in Alpha we use a combination of small models to explore the web and synthesize information. That way we can keep the cost low and the research fast. But this can result in the synthesis not being very long and detailed.
Research Scope
Best suited for topics with publicly available information. May not access paywalled or private content.
Time Constraints
Research jobs are limited to 10 minutes maximum to ensure reasonable response times.
Source Verification
While sources are provided, manual verification of critical information is recommended.
Alpha State
As an Alpha feature, the research methodology and output format may evolve based on feedback.
Billing is done based on the number of urls
analyzed. Each url
is 1 credit. You can specify the max number of urls to analyze with the maxUrls
parameter.