Account

Get a Tavily research task

Retrieves an asynchronous research task by request_id. A 202 response means pending or in_progress; 200 returns a completed report with sources or a failed status. Use Bearer authentication; GET does not accept body api_key credentials. Set include_usage=true to request research credit usage (the completed response reports BazaarLink's settled credits and customer cost).

GET/v1/research/:requestId

Authorizations

Authorizationrequired

string · header

API key as bearer token in the Authorization header.

Path parameters

request_idrequired

string

Unique research-task identifier returned when the task is created.

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

Query parameters

include_usage

boolean

Whether to include credit usage in completed or failed responses; defaults to 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"

Response examples

The task completed or failed. A completed response contains request_id, created_at, content (text or an output_schema-shaped object), sources, and response_time; a failed response contains request_id, status, response_time, and may include 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
  }
}