Search

POST /search

Search and optionally scrape search results

cURL

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>",
  "location": "<string>",
  "timeout": 60000,
  "ignoreInvalidURLs": false,
  "scrapeOptions": {}
}
'

import requests

url = "https://api.firecrawl.dev/v1/search"

payload = {
    "query": "<string>",
    "limit": 5,
    "tbs": "<string>",
    "location": "<string>",
    "timeout": 60000,
    "ignoreInvalidURLs": False,
    "scrapeOptions": {}
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    query: '<string>',
    limit: 5,
    tbs: '<string>',
    location: '<string>',
    timeout: 60000,
    ignoreInvalidURLs: false,
    scrapeOptions: {}
  })
};

fetch('https://api.firecrawl.dev/v1/search', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.firecrawl.dev/v1/search",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'query' => '<string>',
    'limit' => 5,
    'tbs' => '<string>',
    'location' => '<string>',
    'timeout' => 60000,
    'ignoreInvalidURLs' => false,
    'scrapeOptions' => [
        
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.firecrawl.dev/v1/search"

	payload := strings.NewReader("{\n  \"query\": \"<string>\",\n  \"limit\": 5,\n  \"tbs\": \"<string>\",\n  \"location\": \"<string>\",\n  \"timeout\": 60000,\n  \"ignoreInvalidURLs\": false,\n  \"scrapeOptions\": {}\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.firecrawl.dev/v1/search")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"query\": \"<string>\",\n  \"limit\": 5,\n  \"tbs\": \"<string>\",\n  \"location\": \"<string>\",\n  \"timeout\": 60000,\n  \"ignoreInvalidURLs\": false,\n  \"scrapeOptions\": {}\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.firecrawl.dev/v1/search")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"query\": \"<string>\",\n  \"limit\": 5,\n  \"tbs\": \"<string>\",\n  \"location\": \"<string>\",\n  \"timeout\": 60000,\n  \"ignoreInvalidURLs\": false,\n  \"scrapeOptions\": {}\n}"

response = http.request(request)
puts response.read_body

200

{
  "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>",
  "id": "<string>"
}

{
  "success": false,
  "error": "Request timed out"
}

{
  "success": false,
  "error": "An unexpected error occurred on the server."
}

Note: A new v2 version of this API is now available with improved features and performance.

The search endpoint combines web search 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 results (url, title, description).

Supported query operators

We support a variety of query operators that allow you to filter your searches better.

Operator	Functionality	Examples
""	Non-fuzzy matches a string of text	"Firecrawl"
-	Excludes certain keywords or negates other operators	-bad, -site:firecrawl.dev
site:	Only returns results from a specified website	site:firecrawl.dev
inurl:	Only returns results that include a word in the URL	inurl:firecrawl
allinurl:	Only returns results that include multiple words in the URL	allinurl:git firecrawl
intitle:	Only returns results that include a word in the title of the page	intitle:Firecrawl
allintitle:	Only returns results that include multiple words in the title of the page	allintitle:firecrawl playground
related:	Only returns results that are related to a specific domain	related:firecrawl.dev

Location Parameter

Use the location parameter to get geo-targeted search results. Format: "string". Examples: "Germany", "San Francisco,California,United States".

See the complete list of supported locations for all available countries and languages.

Time-Based Search

Use the tbs parameter to filter results by time periods, including custom date ranges. See the Search Feature documentation for detailed examples and supported formats.

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

limit · integer · default: 5

Maximum number of results to return

Required range: 1 <= x <= 100

tbs · string

Time-based search parameter. Supports predefined time ranges (qdr:h, qdr:d, qdr:w, qdr:m, qdr:y) and custom date ranges (cdr:1,cd_min:MM/DD/YYYY,cd_max:MM/DD/YYYY)

location · string

Location parameter for search results

timeout · integer · default: 60000

Timeout in milliseconds

ignoreInvalidURLs · boolean · default: false

Excludes URLs from the search results that are invalid for other Firecrawl endpoints. This helps reduce errors if you are piping data from search into other Firecrawl API endpoints.

scrapeOptions · object

Options for scraping search results

Show child attributes

Response

200

application/json

Successful response

success · boolean

data · object[]

Show child attributes

warning · string | null

Warning message if any issues occurred

id · string

The ID of the search job