Tài khoản

Lấy tác vụ nghiên cứu Tavily

Lấy tác vụ nghiên cứu bất đồng bộ bằng request_id. Phản hồi 202 nghĩa là pending hoặc in_progress; 200 trả về báo cáo completed kèm sources hoặc trạng thái failed. Nên dùng Bearer; có hỗ trợ api_key tùy chọn trong body cho client tương thích, nhưng client GET thường nên dùng header. Đặt include_usage=true để thêm mức dùng credits của research.

GET/v1/research/:requestId

Xác thực

Authorizationbắt buộc

string · header

API key dưới dạng bearer token trong header Authorization.

Tham số đường dẫn

request_idbắt buộc

string

Mã định danh duy nhất của tác vụ được trả khi tạo.

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

Tham số truy vấn

include_usage

boolean

Có thêm mức dùng credits trong phản hồi completed hoặc failed hay không; mặc định 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"

Ví dụ phản hồi

Tác vụ đã hoàn thành hoặc thất bại. Phản hồi completed có request_id, created_at, content (văn bản hoặc đối tượng theo output_schema), sources và response_time; failed có request_id, status, response_time và có thể có 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
  }
}