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
Opérateur | Fonctionnalité | 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’URL | inurl:firecrawl |
allinurl: | Renvoie uniquement des résultats qui incluent plusieurs mots dans l’URL | allinurl:git firecrawl |
intitle: | Renvoie uniquement des résultats qui incluent un mot dans le titre de la page | intitle:Firecrawl |
allintitle: | Renvoie uniquement des résultats qui incluent plusieurs mots dans le titre de la page | allintitle:firecrawl playground |
related: | Renvoie uniquement des résultats liés à un domaine spécifique | related:firecrawl.dev |
Paramètre location
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.
Recherche par période
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
Bearer authentication header of the form Bearer <token>
, where <token>
is your auth token.
Body
application/json
The search query
Maximum number of results to return
Required range:
1 <= x <= 100
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 parameter for search results
Timeout in milliseconds
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.
Options for scraping search results