Skip to main content
POST
/
search
Search for a keyword in Google, returns top page results with markdown content for each page
curl --request POST \
  --url https://api.firecrawl.dev/v0/search \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "query": "<string>",
  "pageOptions": {
    "onlyMainContent": false,
    "fetchPageContent": true,
    "includeHtml": false,
    "includeRawHtml": false
  },
  "searchOptions": {
    "limit": 123
  }
}'
{
  "success": true,
  "data": [
    {
      "url": "<string>",
      "markdown": "<string>",
      "content": "<string>",
      "metadata": {
        "title": "<string>",
        "description": "<string>",
        "language": "<string>",
        "sourceURL": "<string>"
      }
    }
  ]
}
The search endpoint combines a search API with the power of Firecrawl to provide a powerful search experience for whatever query. It automatically searches the web for the query and returns the most relevant results from the top pages in markdown format. The advantage of this endpoint is that it actually scrap each website on the top result so you always get the full content. This endpoint is currently in beta and is subject to change.

Authorizations

​
Authorization
string
header
required

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

Body

application/json
​
query
string<uri>
required

The query to search for

​
pageOptions
object
​
searchOptions
object

Response

Successful response

​
success
boolean
​
data
object[]
⌘I