Tavily Search
Tavily · Research & Search
POST /v1/searchクロール、抽出、URLマッピングによるウェブ検索により、ページやドメイン間での迅速かつ構造化された検索が下流パイプラインに提供されます。
一目で
| フィールド | 価値 |
|---|---|
| モデルID | tavily-search |
| モデル発売日 | - |
| 入力モダリティ | 本文 |
| 出力モダリティ | 本文 |
| コンテキストウィンドウ | - |
| 重量精度 | - |
| 特徴 | web_search、クロール、抽出、マッピング |
| ネイティブ推論 | いいえ |
| 新作 | いいえ |
| サポート端末 | POST /v1/search |
価格設定
| チャージ | スペック | レート |
|---|---|---|
| サーチ(Basic/Fast/ウルトラファスト) | 検索ごとに | $0.0096 |
| 検索(上級) | 検索ごとに | $0.019 |
| 検索(上級+解答) | 検索ごとに | $0.029 |
| エキス(ベーシック) | 5個のURLあたり | $0.0096 |
| エキス(上級) | 5個のURLあたり | $0.019 |
| Crawl/Map(基本) | 10ページあたり | $0.0096 |
例示リクエスト
$ 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"}'
パラメータ
| パラメータ | 種類 | 必須 | デフォルト | 概要 |
|---|---|---|---|---|
query | ストリング | はい | - | 自然言語検索クエリ。 |
operation_mode | エヌム | いいえ | "Search" | 検索 | 抜粋 | 這って | 地図。どのTavilyエンドポイントが実行するかを決定します。·許可:Search、Crawl、Extract、Map |
search_depth | エヌム | いいえ | "basic" | Basic = 高速かつ安価、Advanced = 結果ごとにより深いクロール(完全なコンテンツ)を行います。·許可:basic、advanced |
search_chunks_per_source | 番号 | いいえ | 3 | 各ソースごとに抽出すべき関連コンテンツチャンクの数。·範囲:1 – 3 |
search_topic | エヌム | いいえ | "general" | トピックのプリセット(一般、ニュース、金融など)を検索してください。トピックの別名。·許可:general、news、finance |
include_answer | ブール値 | いいえ | 確かに | 基本的な| 上級 | 間違いだ。結果とともに合成された回答を返します。 |
include_raw_content | ブール値 | いいえ | 偽り | クリーンなテキストと一緒に生のHTMLコンテンツも含めてください。 |
include_images | ブール値 | いいえ | 偽り | 検索結果から画像URLを含めてください。 |
include_image_descriptions | ブール値 | いいえ | 偽り | 返送された画像のAI生成説明を含めてください。 |
include_favicon | ブール値 | いいえ | 偽り | 各ソースのファビコンURLを含めてください。 |
auto_parameters | ブール値 | いいえ | 偽り | クエリTavilysearch_depthや他のノブを自動で選ぶようにしましょう。 |
max_results | 番号 | いいえ | 5 | 返送できる最大結果数(1-50)。·射程:1 – 20 |
time_range | エヌム | いいえ | - | 日 | 週 | 月々 | 年。結果はこの最新期間に制限してください。·許可:day、week、month、year |
start_date | ストリング | いいえ | - | この日付以降に公開された情報源のみを含みます(YYYY-MM-DD)。 |
end_date | ストリング | いいえ | - | この日付以前に発表された情報源のみを含みます(YYYY-MM-DD)。 |
country | ストリング | いいえ | - | 結果を国に偏らせるための2文字のISO 3166-1コード(米国、英国など)。 |
include_domains | ストリング | いいえ | - | カンマ区切られたドメインの許容リスト。これらのドメインからの結果のみが返されます。 |
exclude_domains | ストリング | いいえ | - | フィルターをかけるドメインのカンマ区切り否認リスト。 |
topic | エヌム | いいえ | "general" | 検索トピックプリセット。一般(デフォルト)、ニュース(最近のニュース)、またはファイナンス(市場/ビジネス)。これもsearch_topicとして受け入れられています。·許可:general、news、finance |
days | 番号 | いいえ | - | ニュースの話題の最近の時期は、今日から数日前のことです。·射程:1 – 365 |
crawl_limit | 番号 | いいえ | 10 | 開始URLからクロールできる最大ページ数。·射程:1 – 500 |
crawl_max_depth | 番号 | いいえ | 1 | 開始URLからの最大リンク深度。·範囲:1 – 5 |
crawl_max_breadth | 番号 | いいえ | 20 | ページごとのフォローリンク数の上限。·範囲:1 – 50 |
crawl_extract_depth | エヌム | いいえ | "basic" | クロールした各ページからどれくらい深くコンテンツを抽出するか。·許可:basic、advanced |
crawl_format | エヌム | いいえ | "markdown" | クロールコンテンツの出力フォーマット(マークダウン | テキスト | html)。·許可:markdown、text |
crawl_instructions | ストリング | いいえ | - | クロール中に何を注意すべきかの自然言語の指示。 |
crawl_chunks_per_source | 番号 | いいえ | - | クロールした各ページから抽出するコンテンツチャンクの数。·範囲:1 – 5 |
crawl_select_paths | ストリング | いいえ | - | クロールに含めるカンマ区切られたURLパス。 |
crawl_exclude_paths | ストリング | いいえ | - | クロールから除外するためのカンマ区切られたURLパス。 |
crawl_select_domains | ストリング | いいえ | - | クロールが制限されるカンマ区切られたドメイン。 |
crawl_exclude_domains | ストリング | いいえ | - | カンマ区切られたドメインはクロールでスキップされます。 |
crawl_allow_external | ブール値 | いいえ | 偽り | クローラーが外部ドメインへのリンクをたどることを許可してください。 |
crawl_include_images | ブール値 | いいえ | 偽り | クロール出力には画像URLを含めてください。 |
crawl_include_favicon | ブール値 | いいえ | 偽り | クロールした各ページのファビコンURLを含めてください。 |
crawl_timeout | 番号 | いいえ | 60 | クロールタイムアウトは数秒で完了します。·射程:5 – 300 |
extract_depth | エヌム | いいえ | "basic" | 基本的な| 進んだ。高度な抽出はJavaScriptでレンダリングされたコンテンツを読み込みます。·許可:basic、advanced |
extract_format | エヌム | いいえ | "markdown" | 抽出されたコンテンツの出力フォーマット(マークダウン | テキスト | html)。·許可:markdown、text |
extract_query | ストリング | いいえ | - | 抽出されたコンテンツをフィルタリング・フォーカスするための自然言語クエリ。 |
extract_chunks_per_source | 番号 | いいえ | - | 各URLから抽出するコンテンツチャンクの数。·範囲:1 – 5 |
extract_include_images | ブール値 | いいえ | 偽り | 抽出出力には画像URLを含めてください。 |
extract_include_favicon | ブール値 | いいえ | 偽り | ソースページのファビコンURLを含めてください。 |
extract_timeout | 番号 | いいえ | 10 | 数秒でタイムアウトを抽出します。·範囲:1 – 60 |
map_limit | 番号 | いいえ | 50 | スタートサイトからマッピングできる最大URL数。·範囲:1 – 100 |
map_depth | 番号 | いいえ | 1 | 開始URLからの最大リンク深度。·範囲:1 – 5 |
map_breadth | 番号 | いいえ | 20 | マッピング中にページごとフォローできるリンクの最大数。·範囲:1 – 50 |
map_instructions | ストリング | いいえ | - | マッピング時にどのURLを見つけるべきかの自然言語の指示。 |
map_select_paths | ストリング | いいえ | - | マップが制限されるカンマ区切られたURLパス。 |
map_exclude_paths | ストリング | いいえ | - | コンマ区切られたURLパスはマップがスキップします。 |
map_select_domains | ストリング | いいえ | - | コンマ区切られた領域は、写像が制限される範囲です。 |
map_exclude_domains | ストリング | いいえ | - | カンマ区切られたドメインはマップがスキップします。 |
map_allow_external | ブール値 | いいえ | 偽り | マッパーが外部ドメインへのリンクをたどることを許可します。 |
map_timeout | 番号 | いいえ | 60 | マップタイムアウトは数秒で完了します。·射程:5 – 300 |
disable_formatting | ブール値 | いいえ | 偽り | EmpirioLabsのMarkdownフォーマット(レンダラーによってソース/結果/コードブロックが追加される)は省略してください。生のアップストリームのTavily JSONはパワーユーザーやエージェント向けに返されます。 |
注記
作戦
- 検索、クロール、抽出、地図
捜索深度
- ベーシック、アドバンスド、ファスト、ウルトラファスト
トピック
- 一般、ニュース、財務
Machine-readable schema: GET https://api.empiriolabs.ai/v1/models/tavily-search。