계정

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
  }
}