cURL
Python
JavaScript
PHP
Go
Java
curl --request POST \
--url https://api.firecrawl.dev/v1/search \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"query": "<string>",
"limit": 5,
"tbs": "<string>",
"lang": "en",
"country": "us",
"location": "<string>",
"timeout": 60000,
"scrapeOptions": {}
}' {
"success" : true ,
"data" : [
{
"title" : "<string>" ,
"description" : "<string>" ,
"url" : "<string>" ,
"markdown" : "<string>" ,
"html" : "<string>" ,
"rawHtml" : "<string>" ,
"links" : [
"<string>"
] ,
"screenshot" : "<string>" ,
"metadata" : {
"title" : "<string>" ,
"description" : "<string>" ,
"sourceURL" : "<string>" ,
"statusCode" : 123 ,
"error" : "<string>"
}
}
] ,
"warning" : "<string>"
} The search endpoint combines web search (SERP) with Firecrawl’s scraping capabilities to return full page content for any query.
Include scrapeOptions with formats: ["markdown"] to get complete markdown content for each search result otherwise you will default to getting the SERP results (url, title, description).
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Maximum number of results to return
Required range: 1 <= x <= 10
Time-based search parameter
Language code for search results
Country code for search results
Location parameter for search results
Options for scraping search results
Formats to include in the output
Available options:
markdown,
html,
rawHtml,
links,
screenshot,
screenshot@fullPage,
extract
Description from search result
Markdown content if scraping was requested
HTML content if requested in formats
Raw HTML content if requested in formats
Links found if requested in formats
Screenshot URL if requested in formats
data.metadata. description
Warning message if any issues occurred
