POST
/
search
Search and optionally scrape search results
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": {
    "onlyMainContent": true,
    "includeTags": [
      "<string>"
    ],
    "excludeTags": [
      "<string>"
    ],
    "maxAge": 0,
    "headers": {},
    "waitFor": 0,
    "mobile": false,
    "skipTlsVerification": false,
    "timeout": 30000,
    "parsePDF": true,
    "jsonOptions": {
      "schema": {},
      "systemPrompt": "<string>",
      "prompt": "<string>"
    },
    "actions": [
      {
        "type": "wait",
        "milliseconds": 2,
        "selector": "#my-element"
      }
    ],
    "location": {
      "country": "US",
      "languages": [
        "en-US"
      ]
    },
    "removeBase64Images": true,
    "blockAds": true,
    "proxy": "basic",
    "storeInCache": true,
    "formats": []
  }
}'
{
  "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>"
}
Remarque : une nouvelle version v2 de cette API est désormais disponible avec des fonctionnalités et des performances améliorées.
Le point de terminaison /search combine la recherche web (SERP) avec les capacités de scraping de Firecrawl pour renvoyer le contenu complet des pages pour n’importe quelle requête. Incluez scrapeOptions avec formats: ["markdown"] pour obtenir le contenu Markdown complet pour chaque résultat de recherche ; sinon, par défaut, vous recevrez les résultats du SERP (url, title, description).

Opérateurs de requête pris en charge

Nous prenons en charge divers opérateurs de requête pour affiner vos recherches.
OpérateurFonctionnalitéExemples
""Correspondance exacte d’une chaîne de texte (non floue)"Firecrawl"
-Exclut certains mots‑clés ou inverse d’autres opérateurs-bad, -site:firecrawl.dev
site:Renvoie uniquement des résultats d’un site web spécifiésite:firecrawl.dev
inurl:Renvoie uniquement des résultats qui incluent un mot dans l’URLinurl:firecrawl
allinurl:Renvoie uniquement des résultats qui incluent plusieurs mots dans l’URLallinurl:git firecrawl
intitle:Renvoie uniquement des résultats qui incluent un mot dans le titre de la pageintitle:Firecrawl
allintitle:Renvoie uniquement des résultats qui incluent plusieurs mots dans le titre de la pageallintitle:firecrawl playground
related:Renvoie uniquement des résultats liés à un domaine spécifiquerelated:firecrawl.dev

Paramètre location

Utilisez le paramètre location pour obtenir des résultats de recherche géociblés. Format : "string". Exemples : "Germany", "San Francisco,California,United States". Consultez la liste complète des lieux pris en charge pour tous les pays et langues disponibles. Utilisez le paramètre tbs pour filtrer les résultats par période, y compris selon des plages de dates personnalisées. Consultez la documentation de la fonction de recherche pour des exemples détaillés et les formats pris en charge.

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

Response

Successful response

success
boolean
data
object[]
warning
string | null

Warning message if any issues occurred