tavily research

Prerequisites

curl -fsSL https://cli.tavily.com/install.sh | bash && tvly login

When to use

• You need comprehensive, multi-source analysis
• The user wants a comparison, market report, or literature review
• Quick searches aren't enough — you need synthesis with citations
• Step 5 in the workflow: search → extract → map → crawl → research

Quick start

# Basic research (waits for completion)
tvly research "competitive landscape of AI code assistants"

# Pro model for comprehensive analysis
tvly research "electric vehicle market analysis" --model pro

# Stream results in real-time
tvly research "AI agent frameworks comparison" --stream

# Save report to file
tvly research "fintech trends 2025" --model pro -o fintech-report.md

# JSON output for agents
tvly research "quantum computing breakthroughs" --json

Options

--model

mini

pro

auto

--stream

--no-wait

--output-schema

--citation-format

numbered

mla

apa

chicago

--poll-interval

--timeout

-o, --output

--json

Model selection

mini

pro

auto

Async workflow

# Start without waiting
tvly research "topic" --no-wait --json    # returns request_id

# Check status
tvly research status <request_id> --json

# Wait for completion
tvly research poll <request_id> --json -o result.json

Tips

• Research takes 30-120 seconds — use

  --stream

  to see progress in real-time.
• Use

  --model pro

  for complex comparisons or multi-faceted topics.
• Use

  --output-schema

  to get structured JSON output matching a custom schema.
• For quick facts, use

  tvly search

  instead — research is for deep synthesis.
• Read from stdin:

  echo "query" | tvly research - --json

See also

• tavily-search — quick web search for simple lookups
• tavily-crawl — bulk extract from a site for your own analysis