Skip to main content
POST
Rechercher et éventuellement scraper les résultats de recherche
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.

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

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.

limit
integer
défaut:5

Nombre maximal de résultats à retourner

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

Paramètre de localisation des résultats de recherche

scrapeOptions
object

Options de scraping des résultats de recherche

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

threatProtection
Threat Protection Override · object

Dérogation par requête à la Protection contre les menaces. Les champs que vous fournissez remplacent les champs correspondants de la politique de votre organisation pour cette requête uniquement ; les champs omis conservent leurs valeurs définies au niveau de l’organisation. La Protection contre les menaces doit être activée pour votre équipe (fonctionnalité Enterprise) — sinon, la requête est rejetée avec un code 403. Si votre organisation a désactivé les dérogations par requête, toute requête incluant cet objet est rejetée avec un code 403. Si la Protection contre les menaces est imposée pour votre équipe, mode ne peut pas être défini sur off.

timeout
integer
défaut:60000

Délai d’expiration en millisecondes

Réponse

Réponse en cas de succès

data
object[]
id
string

L’identifiant de la tâche de recherche

success
boolean
warning
string | null

Message d’avertissement en cas de problèmes