Dokumentation API-Referenz SDK-Referenz Agentic-Nutzung KI-Skills

Konto

Tavily-Rechercheaufgabe erstellen

Stellt eine asynchrone Rechercheaufgabe in die Warteschlange. Das erforderliche OpenAPI-Feld heißt input (nicht query); model ist mini, pro oder auto, und stream=true liefert einen SSE-Stream. Bearer-Authentifizierung wird empfohlen, optional ist api_key im JSON-Body möglich. Recherche wird nach tatsächlich verbrauchten Credits nutzungsabhängig abgerechnet: mini liegt dynamisch bei 4–110 Credits, pro bei 15–250 Credits; auto folgt der gewählten Stufe. Das kostenlose Kontingent gilt nicht für Recherche, sondern für search, extract, crawl, map und :online.

POST/v1/research

Autorisierung

Authorizationerforderlich

string · header

API-Schlüssel als Bearer-Token im Authorization-Header.

Body

inputerforderlich

string

Zu untersuchende Aufgabe oder Frage. Das OpenAPI-Feld heißt input; query ist kein Alias.

Example: What are the latest developments in AI?

model

string

Stufe des Recherche-Agenten: mini für fokussierte Fragen, pro für mehrperspektivische Recherche oder auto.

miniproauto

Example: mini

stream

boolean

Ob Rechercheergebnisse als SSE gestreamt werden; Standard ist false.

Example: false

output_schema

object

JSON-Schema für die Ausgabe; properties ist erforderlich, required optional.

propertieserforderlich

object

Eigenschaftsdefinitionen des Ausgabeobjekts; jeder Wert ist ein JSON-Schema-Feld.

required

string[]

Namen der im Ausgabeobjekt erforderlichen Eigenschaften.

Example: ["company"]

citation_format

string

Zitierformat des Rechercheberichts; Standard ist numbered.

numberedmlaapachicago

Example: numbered

include_domains

string[]

Weiche Quellenpräferenz; andere Domains können weiterhin im Bericht erscheinen.

maxItems: 20

Example: ["sec.gov"]

exclude_domains

string[]

Harte Sperrliste für Quelldomains und deren Subdomains.

maxItems: 20

Example: ["reddit.com"]

output_length

string

Zielgröße der Antwort; keine harten Grenzen, Standard ist standard.

shortstandardlong

Example: standard

files

array<object>

Base64-kodierte .txt-, .md- oder .json-Quellen; bis zu 5 Dateien und 80.000 Wörter insgesamt.

maxItems: 5

nameerforderlich

string

Dateiname mit der Erweiterung .txt, .md oder .json.

Example: brief.md

dataerforderlich

string

Base64-kodierter Dateiinhalt.

Example: <base64-encoded file contents>

type

string

Kodierung von data; Standard ist base64.

base64

Example: base64

api_key

string

Optionales BazaarLink-Anmeldedatum im Body; Authorization: Bearer wird empfohlen und das Feld danach entfernt.

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

Antwortbeispiele

Die Rechercheaufgabe wurde eingereiht und gibt request_id, created_at, den Status pending, input, model und response_time zurück.

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
}