Tavily Search
Tavily · Research & Search
POST /v1/searchRecherche web avec crawl, extraction et mappage d’URL pour une récupération rapide et structurée entre pages et domaines pour les pipelines en aval.
En un coup d’œil
| Terrain | Valeur |
|---|---|
| Identifiant de modèle | tavily-search |
| Date de sortie du modèle | - |
| Modalités d’entrée | Texte |
| Modalités de sortie | Texte |
| Fenêtre de contexte | - |
| Précision du poids | - |
| Caractéristiques | web_search, ramper, extraire, cartographier |
| Inférence autochtone | Non |
| Nouveau | Non |
| Points de terminaison pris en charge | POST /v1/search |
Tarification
| Charge | Spec | Taux |
|---|---|---|
| Recherche (Basic/Fast/Ultra-Rapide) | par recherche | $0.0096 |
| Recherche (Avancée) | par recherche | $0.019 |
| Recherche (Avancé + Réponse) | par recherche | $0.029 |
| Extrait (Base) | par 5 URLs | $0.0096 |
| Extrait (Avancé) | par 5 URLs | $0.019 |
| Crawl/Map (basique) | par 10 pages | $0.0096 |
Exemple de demande
$ curl https://api.empiriolabs.ai/v1/search \ > -H 'Authorization: Bearer $EMPIRIOLABS_API_KEY' \ > -H 'Content-Type: application/json' \ > -d '{"model": "tavily-search", "query": "latest LLM benchmarks 2026"}'
Paramètres
| Paramètre | Type | Obligatoire | Par défaut | Description |
|---|---|---|---|---|
query | Corde | Oui | - | La requête de recherche en langage naturel. |
operation_mode | enum | non | "Search" | recherche | extrait | ramper | carte. Détermine quel point de terminaison Tavily s’exécute. · Autorisé: Search, Crawl, Extract, Map |
search_depth | enum | non | "basic" | Basic = rapide et bon marché, avancé = exploration plus profonde par résultat avec contenu complet. · Autorisé: basic, advanced |
search_chunks_per_source | Nombre | non | 3 | Nombre de morceaux de contenu pertinents à extraire par source. · Répartition: 1 – 3 |
search_topic | enum | non | "general" | Prédéfini de sujet de recherche (général, actualités, finance, etc.). Alias du sujet. · Autorisé: general, news, finance |
include_answer | Booléen | non | Vrai | basique | avancé | Faux. Retourne une réponse synthétisée avec les résultats. |
include_raw_content | Booléen | non | faux | Incluez le contenu HTML brut aux côtés du texte nettoyé. |
include_images | Booléen | non | faux | Incluez les URL des images dans les résultats de recherche. |
include_image_descriptions | Booléen | non | faux | Incluez des descriptions générées par l’IA des images retournées. |
include_favicon | Booléen | non | faux | Incluez l’URL favicon de chaque source. |
auto_parameters | Booléen | non | faux | Laissez Tavily choisir automatiquement search_depth et autres boutons en fonction de la requête. |
max_results | Nombre | non | 5 | Nombre maximal de résultats à donner (1-50). · Plage: 1 – 20 |
time_range | enum | non | - | jour | semaine | mois | année. Limitez les résultats à cette fenêtre de récence. · Autorisé: day, week, month, year |
start_date | Corde | non | - | N’incluez que les sources publiées après cette date (AAAAAAAAAAAA-MM-DD). |
end_date | Corde | non | - | N’inclure que les sources publiées avant cette date (AAAAAAAAAAAAAA). |
country | Corde | non | - | Code ISO 3166-1 à deux lettres (États-Unis, GB, etc.) pour la biaisation des résultats vers un pays. |
include_domains | Corde | non | - | Liste de permis séparée par virgule des domaines. Seuls les résultats de ces domaines sont retournés. |
exclude_domains | Corde | non | - | Déniation des domaines séparés par virgules à filtrer. |
topic | enum | non | "general" | Prédéfini sujet de recherche. Général (défaut), actualités (actualités récentes) ou finance (marchés / affaires). Accepté aussi comme search_topic. · Autorisé: general, news, finance |
days | Nombre | non | - | Fenêtre de récence pour le sujet d’actualité, dans quelques jours à partir d’aujourd’hui. · Portée: 1 – 365 |
crawl_limit | Nombre | non | 10 | Nombre maximal de pages à explorer à partir de l’URL de départ. · Plage: 1 – 500 |
crawl_max_depth | Nombre | non | 1 | Profondeur maximale de lien à partir de l’URL de départ. · Répartition: 1 – 5 |
crawl_max_breadth | Nombre | non | 20 | Nombre maximal de liens à suivre par page. · Plage: 1 – 50 |
crawl_extract_depth | enum | non | "basic" | Jusqu’où extraire le contenu de chaque page explorée. · Autorisé: basic, advanced |
crawl_format | enum | non | "markdown" | Format de sortie pour le contenu exploré (markdown | texte | html). · Autorisé: markdown, text |
crawl_instructions | Corde | non | - | Instructions en langage naturel sur ce qu’il faut surveiller pendant le rampement. |
crawl_chunks_per_source | Nombre | non | - | Nombre de morceaux de contenu à extraire de chaque page explorée. · Répartition: 1 – 5 |
crawl_select_paths | Corde | non | - | Des chemins d’URL séparés par virgules à inclure dans l’exploration. |
crawl_exclude_paths | Corde | non | - | Des chemins d’URL séparés par virgules à exclure de l’exploration. |
crawl_select_domains | Corde | non | - | Domaines séparés par virgules auxquels l’exploration est limitée. |
crawl_exclude_domains | Corde | non | - | Les domaines séparés par virgules que le crawl sautera. |
crawl_allow_external | Booléen | non | faux | Permettre à l’outil d’indexation de suivre les liens vers des domaines externes. |
crawl_include_images | Booléen | non | faux | Incluez les URL d’images dans la sortie d’exploration. |
crawl_include_favicon | Booléen | non | faux | Incluez l’URL favicon de chaque page explorée. |
crawl_timeout | Nombre | non | 60 | Temps d’arrêt en quelques secondes. · Portée: 5 – 300 |
extract_depth | enum | non | "basic" | basique | avancé. L’extraction avancée lit le contenu rendu en JavaScript. · Autorisé: basic, advanced |
extract_format | enum | non | "markdown" | Format de sortie pour le contenu extrait (markdown | texte | html). · Autorisé: markdown, text |
extract_query | Corde | non | - | Requête en langage naturel pour filtrer / focaliser le contenu extrait. |
extract_chunks_per_source | Nombre | non | - | Nombre de blocs de contenu à extraire de chaque URL. · Répartition: 1 – 5 |
extract_include_images | Booléen | non | faux | Incluez les URL d’images dans la sortie d’extraction. |
extract_include_favicon | Booléen | non | faux | Incluez l’URL favicon de la page source. |
extract_timeout | Nombre | non | 10 | Extraction en secondes. · Plage: 1 – 60 |
map_limit | Nombre | non | 50 | Nombre maximal d’URL à cartographier depuis le site de départ. · Portée: 1 – 100 |
map_depth | Nombre | non | 1 | Profondeur maximale de lien à partir de l’URL de départ. · Répartition: 1 – 5 |
map_breadth | Nombre | non | 20 | Nombre maximal de liens à suivre par page lors du cartographie. · Plage: 1 – 50 |
map_instructions | Corde | non | - | Instructions en langage naturel pour les URL à trouver lors du mapping. |
map_select_paths | Corde | non | - | Chemins d’URL séparés par virgules auxquels la carte est limitée. |
map_exclude_paths | Corde | non | - | Les chemins d’URL séparés par virgules que la carte sautera. |
map_select_domains | Corde | non | - | Domaines séparés par virgules auxquels l’application est restreinte. |
map_exclude_domains | Corde | non | - | Domaines séparés par virgules que la carte passera à côté. |
map_allow_external | Booléen | non | faux | Permettre au mapper de suivre les liens vers des domaines externes. |
map_timeout | Nombre | non | 60 | Délai d’attente de la carte en quelques secondes. · Portée: 5 – 300 |
disable_formatting | Booléen | non | faux | Évitez la mise en forme Markdown d’EmpirioLabs (Sources / Résultats / blocs de code ajoutés par le moteur de rendu). Le JSON brut en amont de Tavily est retourné pour les utilisateurs avancés / agents. |
Notes
Opérations
- Recherche, Exploration, Extraction, Carte
Profondeur de recherche
- Basique, avancé, rapide, ultra-rapide
Sujets
- Général, actualités, finances
_Machine schéma lisible: _ GET https://api.empiriolabs.ai/v1/models/tavily-search.