帳戶

取得 Tavily 研究結果

依 request_id 查詢非同步研究工作。202 表示 pending 或 in_progress；200 回傳 completed 報告與 sources，或 failed 狀態。Bearer 是偏好的驗證方式，也可使用可選 body api_key（GET 請求通常使用標頭）。include_usage=true 時包含研究 credits 使用量。

GET/v1/research/:requestId

驗證

Authorization必填

string · header

在 Authorization 標頭以 Bearer token 傳入 API 金鑰。

路徑參數

request_id必填

string

建立研究工作時回傳的唯一工作識別碼。

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

查詢參數

include_usage

boolean

是否在完成或失敗的回應中包含 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 會包含 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
  }
}