Passer au contenu principal
POST
/
search
Rechercher et éventuellement scraper les résultats de recherche
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": {}
}
'
{
  "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 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 uniquement les résultats (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.

Autorisations

Authorization
string
header
requis

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

Corps

application/json
query
string
requis

La requête de recherche

limit
integer
défaut:5

Nombre maximal de résultats à retourner

Plage requise: 1 <= x <= 100
tbs
string

Paramètre de recherche temporel. Prend en charge les intervalles de temps prédéfinis (qdr:h, qdr:d, qdr:w, qdr:m, qdr:y) et les plages de dates personnalisées (cdr:1,cd_min:MM/DD/YYYY,cd_max:MM/DD/YYYY).

location
string

Paramètre de localisation des résultats de recherche

timeout
integer
défaut:60000

Délai d’expiration en millisecondes

ignoreInvalidURLs
boolean
défaut:false

Exclut des résultats de recherche les URL qui ne sont pas valides pour d’autres endpoints de Firecrawl. Cela permet de réduire les erreurs si vous transférez les données issues de la recherche vers d’autres endpoints de l’API Firecrawl.

scrapeOptions
object

Options de scraping des résultats de recherche

Réponse

Réponse en cas de succès

success
boolean
data
object[]
warning
string | null

Message d’avertissement en cas de problèmes