アカウント

Tavily リサーチタスクを取得

request_id で非同期リサーチタスクを取得します。202 は pending または in_progress、200 は sources 付きの completed レポートまたは failed 状態を返します。Bearer 認証を推奨します。対応するクライアントでは任意の body api_key も使えますが、GET では通常ヘッダーを使います。include_usage=true で研究の credits 使用量を含めます。

GET/v1/research/:requestId

認証

Authorization必須

string · header

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

パスパラメータ

request_id必須

string

タスク作成時に返される一意のリサーチタスク識別子。

Example: 123e4567-e89b-12d3-a456-426614174111

クエリパラメータ

include_usage

boolean

completed または failed のレスポンスに credits 使用量を含めるか。既定値は false。

Example: true

GET /v1/research/:requestId

1
2
curl "https://api.bazaarlink.ai/v1/research/$REQUEST_ID?include_usage=true" \
  -H "Authorization: Bearer $BAZAARLINK_API_KEY"

レスポンス例

タスクが completed または failed になりました。completed には request_id、created_at、content（テキストまたは output_schema に従うオブジェクト）、sources、response_time が含まれ、failed には request_id、status、response_time と任意の usage が含まれます。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
{
  "request_id": "123e4567-e89b-12d3-a456-426614174111",
  "created_at": "2025-01-15T10:30:00Z",
  "status": "completed",
  "content": "Research Report: Latest Developments in AI",
  "sources": [
    {
      "title": "Latest AI Developments",
      "url": "https://example.com/ai-news",
      "favicon": "https://example.com/favicon.ico"
    }
  ],
  "response_time": 1.23,
  "usage": {
    "credits": 16
  }
}