Docs API Reference SDK Reference Agentic Usage AI Skills

Account

Create a Tavily research task

Queues an asynchronous research task. The OpenAPI request field is required input (not query); model is mini, pro, or auto. stream=true is rejected with HTTP 400 because streaming is not supported yet. Bearer authentication is preferred, with optional body api_key compatibility. Research is billed per use from credits actually consumed: dynamic mini usage is within 4–110 credits and pro within 15–250 credits; auto follows the selected tier. The free allowance does not apply to research; it covers search, extract, crawl, map, and :online.

POST/v1/research

Authorizations

Authorizationrequired

string · header

API key as bearer token in the Authorization header.

Body

inputrequired

string

Research task or question to investigate. The OpenAPI field is input; query is not an alias.

Example: What are the latest developments in AI?

model

string

Research-agent tier: mini for focused questions, pro for multi-angle research, or auto for service selection.

miniproauto

Example: mini

stream

boolean

Whether to stream research results; stream=true is rejected with HTTP 400 because streaming is not supported yet. Defaults to false.

Example: false

output_schema

object

JSON Schema for the research output; it must include properties and may include required.

propertiesrequired

object

Property definitions for the output object; each value is a JSON Schema field.

required

string[]

Names of properties required in the output object.

Example: ["company"]

citation_format

string

Citation format for the research report; defaults to numbered.

numberedmlaapachicago

Example: numbered

include_domains

string[]

Soft source preference; other domains may still appear in the report.

maxItems: 20

Example: ["sec.gov"]

exclude_domains

string[]

Hard blocklist of source domains and their subdomains.

maxItems: 20

Example: ["reddit.com"]

output_length

string

Target response size; these are targets rather than hard caps, defaulting to standard.

shortstandardlong

Example: standard

files

array<object>

Base64-encoded .txt, .md, or .json sources; up to 5 files and 80,000 combined words.

maxItems: 5

namerequired

string

Filename including a .txt, .md, or .json extension.

Example: brief.md

datarequired

string

Base64-encoded file contents.

Example: <base64-encoded file contents>

type

string

Encoding of data; defaults to base64.

base64

Example: base64

api_key

string

Optional BazaarLink body credential; prefer Authorization: Bearer. It is removed after authentication.

Example: YOUR_BAZAARLINK_API_KEY

POST /v1/research

1
2
3
4
curl -X POST https://api.bazaarlink.ai/v1/research \
  -H "Authorization: Bearer $BAZAARLINK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"input":"What are the latest developments in AI?","model":"mini"}'

Response examples

The research task was queued and returns request_id, created_at, pending status, input, model, and response_time.

1
2
3
4
5
6
7
8
{
  "request_id": "123e4567-e89b-12d3-a456-426614174111",
  "created_at": "2025-01-15T10:30:00Z",
  "status": "pending",
  "input": "What are the latest developments in AI?",
  "model": "mini",
  "response_time": 1.23
}