ドキュメント APIリファレンス SDKリファレンスエージェント利用 AIスキル

アカウント

Tavily リサーチタスクを作成

非同期のリサーチタスクをキューに入れます。OpenAPI で必須の入力フィールドは input（query ではありません）です。model は mini、pro、auto のいずれかで、stream=true では SSE ストリームを返します。Bearer 認証を推奨し、JSON body の任意の api_key も使えます。研究は実際に消費した credits に基づく従量課金で、mini は動的に 4～110 credits、pro は 15～250 credits、auto は選択されたティアに従います。無料枠は研究には適用されず、search、extract、crawl、map、:online を対象とします。

POST/v1/research

認証

Authorization必須

string · header

Authorization ヘッダーに Bearer トークンとして API キーを渡します。

Body

input必須

string

調査するタスクまたは質問。OpenAPI のフィールドは input で、query は別名ではありません。

Example: What are the latest developments in AI?

model

string

リサーチエージェントのティア。狭い質問は mini、多面的な調査は pro、サービス選択は auto。

miniproauto

Example: mini

stream

boolean

研究結果を SSE でストリーミングするか。既定値は false。

Example: false

output_schema

object

研究出力の JSON Schema。properties が必須で、required は任意です。

properties必須

object

出力オブジェクトのプロパティ定義。各値は JSON Schema のフィールドです。

required

string[]

出力オブジェクトで必須となるプロパティ名の一覧。

Example: ["company"]

citation_format

string

研究レポートの引用形式。既定値は numbered。

numberedmlaapachicago

Example: numbered

include_domains

string[]

ソースの優先候補。他のドメインもレポートに含まれる場合があります。

maxItems: 20

Example: ["sec.gov"]

exclude_domains

string[]

ソースドメインとサブドメインの強制ブロックリスト。

maxItems: 20

Example: ["reddit.com"]

output_length

string

応答サイズの目標。厳密な上限ではなく、既定値は standard です。

shortstandardlong

Example: standard

files

array<object>

Base64 の .txt、.md、.json ソース。最大 5 ファイル、合計 80,000 語までです。

maxItems: 5

name必須

string

.txt、.md、.json のいずれかの拡張子を含むファイル名。

Example: brief.md

data必須

string

ファイル内容を Base64 エンコードした値。

Example: <base64-encoded file contents>

type

string

data のエンコーディング。既定値は base64 です。

base64

Example: base64

api_key

string

BazaarLink の任意の body 認証情報。Authorization: Bearer を推奨し、認証後にこのフィールドを除去します。

Example: YOUR_BAZAARLINK_API_KEY

POST /v1/research

1
2
3
4
curl -X POST https://api.bazaarlink.ai/v1/research \
  -H "Authorization: Bearer $BAZAARLINK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"input":"What are the latest developments in AI?","model":"mini"}'

レスポンス例

リサーチタスクをキューに追加し、request_id、created_at、pending 状態、input、model、response_time を返します。

1
2
3
4
5
6
7
8
{
  "request_id": "123e4567-e89b-12d3-a456-426614174111",
  "created_at": "2025-01-15T10:30:00Z",
  "status": "pending",
  "input": "What are the latest developments in AI?",
  "model": "mini",
  "response_time": 1.23
}