- Choose specific output formats (markdown, HTML, links, screenshots)
- Search the web with customizable parameters (location, etc.)
- Optionally retrieve content from search results in various formats
- Control the number of results and set timeouts
Performing a Search with Firecrawl
/search endpoint
Used to perform web searches and optionally retrieve content from the results.Installation
Basic Usage
Response
SDKs will return the data object directly. cURL will return the complete payload.JSON
Search result types
In addition to regular web results, Search supports specialized result types via thesources
parameter:
web
: standard web results (default)news
: news-focused resultsimages
: image search results
Search Categories
Filter search results by specific categories using thecategories
parameter:
github
: Search within GitHub repositories, code, issues, and documentationresearch
: Search academic and research websites (arXiv, Nature, IEEE, PubMed, etc.)
GitHub Category Search
Search specifically within GitHub repositories:cURL
Research Category Search
Search academic and research websites:cURL
Mixed Category Search
Combine multiple categories in one search:cURL
Category Response Format
Each search result includes acategory
field indicating its source:
cURL
cURL
HD Image Search with Size Filtering
Use Google Images operators to find high-resolution images:cURL
cURL
imagesize:1920x1080
- Full HD (1080p)imagesize:2560x1440
- QHD (1440p)imagesize:3840x2160
- 4K UHDlarger:1920x1080
- HD and abovelarger:2560x1440
- QHD and above
Search with Content Scraping
Search and retrieve content from the search results in one operation.scrapeOptions
parameter.
Response with Scraped Content
Advanced Search Options
Firecrawl’s search API supports various parameters to customize your search:Location Customization
Time-Based Search
Use thetbs
parameter to filter results by time:
tbs
values:
qdr:h
- Past hourqdr:d
- Past 24 hoursqdr:w
- Past weekqdr:m
- Past monthqdr:y
- Past year
Custom Timeout
Set a custom timeout for search operations:Cost Implications
The cost of using this endpoint is 1 credit per search result. There is no additional charge for basic scrapes of each search result. However, be aware of these cost factors:- PDF parsing: 1 credit per PDF page (can significantly increase costs for multi-page PDFs)
- Stealth proxy mode: +4 additional credits per search result
- JSON mode: +4 additional credits per search result
- Set
parsers: []
if you don’t need PDF content - Use
proxy: "basic"
instead of"stealth"
when possible - Limit the number of search results with the
limit
parameter