POST
/
search

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).

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

The search query

country
string
default:
us

Country code for search results

lang
string
default:
en

Language code for search results

limit
integer
default:
5

Maximum number of results to return

Required range: 1 < x < 10
location
string

Location parameter for search results

scrapeOptions
object

Options for scraping search results

tbs
string

Time-based search parameter

timeout
integer
default:
60000

Timeout in milliseconds

Response

200 - application/json
data
object[]
success
boolean
warning
string | null

Warning message if any issues occurred