Web Content
Web crawling, URL discovery and page extraction.
Tavily Extract
Extrait le contenu lisible d'une URL ou d'un tableau d'URLs. Choisissez texte ou Markdown avec format. Vérifiez results et failed_results : une URL en échec peut être signalée dans une réponse HTTP par ailleurs réussie. Définissez include_usage pour recevoir les informations d'utilisation des ressources ; usage.credits n'est pas un débit Felo.
Référence tarifaire
- Mesure : unités de réponse mesurées.
- Estimation de référence par requête : USD 0.024.
- Base de coût unitaire : USD 0.008.
- Unité de ressource :
tavily_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.
- urlsobligatoire
L'URL ou les URL à partir desquelles extraire le contenu. Une chaîne d'URL unique et un tableau de chaînes d'URL sont tous deux acceptés.
- Type: string
L'URL ou les URL à partir desquelles extraire le contenu. Une chaîne d'URL unique et un tableau de chaînes d'URL sont tous deux acceptés.
- Type: integerchunks
_per _source min.:1max.:5Nombre maximal de fragments pertinents renvoyés par source. Disponible uniquement lorsque query est fourni.
- Type: string enumextract
_depth Profondeur du processus d'extraction.
valeurs- basic
- advanced
- Type: string enumformat
Format du contenu extrait de la page web.
valeurs- markdown
- text
- Type: booleaninclude
_favicon Inclure l'URL du favicon pour chaque résultat.
- Type: booleaninclude
_images Inclure une liste d'images extraites des URL.
- Type: booleaninclude
_usage Inclure les informations d'utilisation des ressources dans la réponse. Il ne s'agit pas d'informations de facturation Felo.
- Type: stringquery
Intention de l'utilisateur pour le reclassement des fragments de contenu extraits.
- Type: number Format: floattimeoutmin.:1max.:60
Temps maximal en secondes d'attente de l'extraction d'URL. S'il est omis, les délais d'attente par défaut dépendent de extract_depth : 10 secondes pour basic et 30 secondes pour advanced.
- Type: object200
Résultats d'extraction renvoyés avec succès.
- Type: array string[]failed
_results Liste des URL qui n'ont pas pu être traitées.
- Type: stringrequest
_id Identifiant unique de la requête.
- Type: number Format: floatresponse
_time Temps en secondes nécessaire pour traiter la requête.
- Type: array object[]results
- faviconType: string | null
URL du favicon du contenu extrait.
- imagesType: array string[]
Images extraites de l'URL lorsque include_images est true.
- rawType: string
_content Contenu brut extrait de l'URL.
- titleType: string
Titre de la page extraite.
- urlType: string
URL du contenu extrait.
- Type: objectusage
- creditsType: integer
Unités de ressources consommées par cette requête, et non des USD ou des crédits Felo.
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 --request POST https://openapi.felo.ai/v1/beta/tavily/extract \
--header "Authorization: Bearer ${FELO_API_KEY:?Set FELO_API_KEY}" \
--header 'Content-Type: application/json' \
--data '{"urls": ["https://example.com"], "extract_depth": "basic", "format": "text", "include_usage": true}'
{
"results": [
{
"url": "https://example.com",
"title": "Example Domain",
"raw_content": "This domain is for use in documentation examples.",
"images": []
}
],
"failed_results": [],
"response_time": 0.5,
"usage": {
"credits": 1
},
"request_id": "example-extract-request"
}