Exécuter une recherche web et renvoyer des résultats classés.
Firecrawl
Search, scrape, map, file parsing and asynchronous crawling.
Exécuter une recherche web et renvoyer des résultats classés.
Recherche le web et renvoie des résultats classés. query est obligatoire ; limit définit leur nombre. Renvoie success, creditsUsed, un id de requête et data.web[] avec url, title, description et position — titres et extraits uniquement, aucun texte de page. Passez à autre chose lorsque : vous voulez le texte de la page dans le même appel — searchWeb le renvoie et répond en un tiers du temps ; vous connaissez déjà les URL — post_firecrawl_scrape ; vous voulez une pertinence jugée sur le sens plutôt que sur les mots-clés — post_exa_search.
Référence tarifaire
- Mesure : nombre de résultats mesurés.
- Estimation de référence par requête : USD 0.002142.
- Base de coût unitaire : USD 0.001071.
- Unité de ressource :
firecrawl_credit. - Multiplicateur client de référence : 1.0. Ne pas l'appliquer à nouveau à un montant client déjà réglé.
- Les bases de coût ne déterminent pas le prix client final, y compris lorsqu'elles valent zéro.
Métadonnées de référence uniquement, et non un devis de compte, un prix garanti ou un plafond de dépenses. Les crédits de ressources ne sont pas des crédits Felo. Les débits définitifs suivent les enregistrements de facturation Felo.
- Type: stringquerylongueur min.:1longueur max.:2000obligatoire
- Type: boolean enumenterpriseconstante:falsevaleurs
- false
- Type: integerlimitmin.:1max.:100
Integer numbers.
- Type: array string[] 1…1enumsourcesconstante:[ "web" ]valeurs
- web
- Type: object200
Recherche réussie.
- Type: integercredits
Used Crédits Firecrawl consommés (environ 2 pour 10 résultats).
- Type: objectdata
- webType: array object[]
Résultats de recherche web classés.
- descriptionType: string
Extrait du résultat.
- titleType: string
Titre du résultat.
- urlType: string
URL du résultat.
- Type: booleansuccess
Vrai lorsque la recherche a réussi.
application/json - 400
La requête n'a pas pu être traitée. Vérifiez les paramètres de la requête.
- 401
Une clé API Felo valide est requise.
- 402
La requête ne peut pas aboutir car une condition de facturation n'est pas remplie.
- 403
Le compte n'est pas autorisé à effectuer cette opération.
- 429
Une limite de requêtes ou de dépenses a été atteinte.
- 502
Le service n'a pas pu terminer la requête.
- 503
L'API ou le service de facturation est temporairement indisponible.
- 504
Le service a expiré lors du traitement de la requête.
- default
Réponse d'erreur ; les réponses transmises depuis l'upstream peuvent utiliser les formats du fournisseur
application/json
curl https://openapi.felo.ai/v1/beta/firecrawl/search \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '{
"enterprise": false,
"limit": 10,
"query": "nike",
"sources": [
"web"
]
}'
{
"success": true,
"data": {
"web": [
{
"title": "string",
"url": "string",
"description": "string"
}
]
},
"creditsUsed": 1
}