Tavily Search
Tavily · Research & Search
POST /v1/searchWebsuche mit Crawl-, Extraktions- und URL-Mapping für schnelle, strukturierte Abrufe über Seiten und Domains für nachgelagerte Pipelines.
Auf einen Blick
| Spielfeld | Wert |
|---|---|
| Modell-ID | tavily-search |
| Modell-Veröffentlichungsdatum | - |
| Eingabemodalitäten | Text |
| Ausgabemodalitäten | Text |
| Kontextfenster | - |
| Gewichtspräzision | - |
| Merkmale | web_search, kriechen, extrahieren, kartieren |
| Native Schlussfolgerung | Nein |
| Neu | Nein |
| Unterstützte Endpunkte | POST /v1/search |
Preisgestaltung
| Berechnen | Spezifikation | Zinssatz |
|---|---|---|
| Suche (Basic/Fast/Ultra-schnell) | pro Suche | $0.0096 |
| Suche (Erweitert) | pro Suche | $0.019 |
| Suche (Erweitert + Antwort) | pro Suche | $0.029 |
| Extrakt (Basic) | pro 5 URLs | $0.0096 |
| Auszug (Fortgeschritten) | pro 5 URLs | $0.019 |
| Crawl/Map (Grundlegend) | pro 10 Seiten | $0.0096 |
Beispielanfrage
$ 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"}'
Parameter
| Parameter | Typ | Erforderlich | Default | Beschreibung |
|---|---|---|---|---|
query | String | Ja | - | Die Suchanfrage in natürlicher Sprache. |
operation_mode | ENUM | Nein | "Search" | Suche | Extrakt | Kriechen | Karte. Bestimmt, welcher Tavily-Endpunkt läuft. · Erlaubt: Search, Crawl, Extract, Map |
search_depth | ENUM | Nein | "basic" | Basic = schnell und günstig, Advanced = tieferer Crawl mit vollständigem Inhalt. · Erlaubt: basic, advanced |
search_chunks_per_source | Anzahl | Nein | 3 | Anzahl der relevanten Inhaltsabschnitte, die pro Quelle extrahiert werden müssen. · Reichweite: 1 – 3 |
search_topic | ENUM | Nein | "general" | Suchthemen-Voreinstellungen (allgemein, Nachrichten, Finanzen usw.). Alias des Themas. · Erlaubt: general, news, finance |
include_answer | Boolean | Nein | Stimmt | Basic | Fortgeschritten | falsch. Gibt zusammen mit den Ergebnissen eine synthetisierte Antwort zurück. |
include_raw_content | Boolean | Nein | falsch | Fügen Sie den rohen HTML-Inhalt zusammen mit gelöschtem Text hinzu. |
include_images | Boolean | Nein | falsch | Fügen Sie Bild-URLs aus den Suchergebnissen hinzu. |
include_image_descriptions | Boolean | Nein | falsch | Fügen Sie KI-generierte Beschreibungen der zurückgegebenen Bilder ein. |
include_favicon | Boolean | Nein | falsch | Fügen Sie die Favicon-URL jeder Quelle hinzu. |
auto_parameters | Boolean | Nein | falsch | Lass Tavily search_depth und andere Knöpfe basierend auf der Abfrage automatisch auswählen. |
max_results | Anzahl | Nein | 5 | Maximale Anzahl an Ergebnissen (1-50). · Reichweite: 1 – 20 |
time_range | ENUM | Nein | - | Tag | Woche | Monat | Jahr. Beschränke die Ergebnisse auf dieses Aktualitätsfenster. · Erlaubt: day, week, month, year |
start_date | String | Nein | - | Beziehen Sie nur Quellen, die nach diesem Datum veröffentlicht wurden (JJJJ-MM-DD). |
end_date | String | Nein | - | Beziehen Sie nur Quellen auf, die vor diesem Datum veröffentlicht wurden (JJJJJ-MM-DD). |
country | String | Nein | - | Zweibuchstabiger ISO-3166-1-Code (US, GB usw.) zur Verzerrung von Ergebnissen zugunsten eines Landes. |
include_domains | String | Nein | - | Komma-getrennte Erlaubtenliste der Domänen. Nur Ergebnisse aus diesen Domänen werden zurückgegeben. |
exclude_domains | String | Nein | - | Komma-separierte Denylist der Domänen zum Filtern. |
topic | ENUM | Nein | "general" | Such-Topic-Preset. Allgemein (Zahlungsausfall), Nachrichten (aktuelle Nachrichten) oder Finanzen (Märkte / Geschäft). Auch als search_topic angenommen. · Erlaubt: general, news, finance |
days | Anzahl | Nein | - | Aktuelles Zeitfenster für das Nachrichtenthema, in einigen Tagen von heute. · Reichweite: 1 – 365 |
crawl_limit | Anzahl | Nein | 10 | Maximal die Anzahl der Seiten, die von der Start-URL gecrawlt werden können. · Reichweite: 1 – 500 |
crawl_max_depth | Anzahl | Nein | 1 | Maximale Linktiefe von der Start-URL. · Reichweite: 1 – 5 |
crawl_max_breadth | Anzahl | Nein | 20 | Maximale Anzahl an Links pro Seite. · Reichweite: 1 – 50 |
crawl_extract_depth | ENUM | Nein | "basic" | Wie tief man Inhalte von jeder gecrawlten Seite extrahiert. · Erlaubt: basic, advanced |
crawl_format | ENUM | Nein | "markdown" | Ausgabeformat für gecrawlte Inhalte (Markdown | Text | html). · Erlaubt: markdown, text |
crawl_instructions | String | Nein | - | Anleitungen in natürlicher Sprache, worauf man beim Crawlen achten sollte. |
crawl_chunks_per_source | Anzahl | Nein | - | Anzahl der Inhaltsabschnitte, die von jeder gecrawlten Seite extrahiert werden müssen. · Reichweite: 1 – 5 |
crawl_select_paths | String | Nein | - | Komma-getrennte URL-Pfade, die in den Crawl aufgenommen werden. |
crawl_exclude_paths | String | Nein | - | Komma-getrennte URL-Pfade, die vom Crawl ausgeschlossen werden sollen. |
crawl_select_domains | String | Nein | - | Komma-separierte Domänen ist auf das Crawl beschränkt. |
crawl_exclude_domains | String | Nein | - | Komma-getrennte Domänen überspringt der Crawl. |
crawl_allow_external | Boolean | Nein | falsch | Erlaube dem Crawler, Links zu externen Domains zu folgen. |
crawl_include_images | Boolean | Nein | falsch | Fügen Sie Bild-URLs in die Crawl-Ausgabe ein. |
crawl_include_favicon | Boolean | Nein | falsch | Fügen Sie die Favicon-URL jeder gecrawlten Seite hinzu. |
crawl_timeout | Anzahl | Nein | 60 | Crawl Timeout in Sekunden. · Reichweite: 5 – 300 |
extract_depth | ENUM | Nein | "basic" | Basic | fortgeschritten. Erweiterte Extraktion liest JavaScript-gerenderte Inhalte. · Erlaubt: basic, advanced |
extract_format | ENUM | Nein | "markdown" | Ausgabeformat für extrahierte Inhalte (Markdown | Text | html). · Erlaubt: markdown, text |
extract_query | String | Nein | - | Natürliche Sprachanfrage zum Filtern / Fokussieren der extrahierten Inhalte. |
extract_chunks_per_source | Anzahl | Nein | - | Anzahl der Inhaltsabschnitte, die aus jeder URL extrahiert werden müssen. · Reichweite: 1 – 5 |
extract_include_images | Boolean | Nein | falsch | Fügen Sie Bild-URLs in die Extraktausgabe ein. |
extract_include_favicon | Boolean | Nein | falsch | Fügen Sie die Favicon-URL der Quellseite hinzu. |
extract_timeout | Anzahl | Nein | 10 | Extraher-Timeout in Sekunden. · Reichweite: 1 – 60 |
map_limit | Anzahl | Nein | 50 | Maximal viele URLs, die von der Startseite aus zuordnet werden müssen. · Reichweite: 1 – 100 |
map_depth | Anzahl | Nein | 1 | Maximale Linktiefe von der Start-URL. · Reichweite: 1 – 5 |
map_breadth | Anzahl | Nein | 20 | Maximale Anzahl an Links pro Seite während der Kartierung. · Reichweite: 1 – 50 |
map_instructions | String | Nein | - | Natürlichsprachliche Anweisungen, welche URLs beim Mapping gefunden werden sollen. |
map_select_paths | String | Nein | - | Komma-getrennte URL-Pfade sind auf die Karte beschränkt. |
map_exclude_paths | String | Nein | - | Komma-getrennte URL-Pfade, die die Karte überspringt. |
map_select_domains | String | Nein | - | Komma-separierte Domänen, auf die die Abbildung beschränkt ist. |
map_exclude_domains | String | Nein | - | Komma-getrennte Domänen überspringt die Karte. |
map_allow_external | Boolean | Nein | falsch | Erlaube dem Mapper, Links zu externen Domänen zu folgen. |
map_timeout | Anzahl | Nein | 60 | Karten-Timeout in Sekunden. · Reichweite: 5 – 300 |
disable_formatting | Boolean | Nein | falsch | Überspringe die EmpirioLabs Markdown-Formatierung (Quellen / Ergebnisse / Codeblöcke, die vom Renderer hinzugefügt werden). Das rohe Upstream-Tavily-JSON wird für Power-User / Agenten zurückgegeben. |
Anmerkungen
Betrieb
- Suchen, Durchkriechen, Extrahieren, Kartieren
Suchtiefen
- Basic, Advanced, schnell, ultraschnell
Themen
- Allgemein, Nachrichten, Finanzen
Machine-lesbares Schema: GET https://api.empiriolabs.ai/v1/models/tavily-search.