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

Websuche

Website-URLs kartieren

Erkunden Sie ab einer Stamm-URL den Linkgraphen einer Website und geben Sie die gefundenen URLs zurück. Dies ist ein reiner Discovery-Endpunkt ohne Inhalts-Extraktionsfelder. Authentifizieren Sie sich mit einem Bearer-API-Schlüssel oder übergeben Sie api_key als Kompatibilitätsfallback im JSON-Body; beide Basis-URLs werden unterstützt. Unbekannte Felder werden ignoriert. Die Antwort enthält base_url, ein results-Array mit URL-Strings, response_time, unsere additiven Felder usage.credits und usage.cost nach dem vom Administrator festgelegten Preis pro Credit sowie request_id. Mapping kostet 1 Credit je 10 erfolgreiche Seiten oder 2 Credits, wenn instructions gesetzt ist; fehlgeschlagene Seiten sind kostenlos. Tatsächliche Credits werden dem gemeinsamen täglichen Freikontingent entnommen. Überschreitet die Schätzung aus limit den Rest, wird der Überschuss vom Guthaben abgerechnet oder ohne Guthaben mit 432 zurückgewiesen und ein kleineres limit empfohlen. SDK-Beispiele; speichern Sie den Schlüssel in einer Umgebungsvariable oder einer anderen sicheren serverseitigen Einstellung. Python: from tavily import TavilyClient client = TavilyClient(api_key="...", api_base_url="https://api.bazaarlink.ai/v1") response = client.map("docs.tavily.com") JavaScript: import { tavily } from "@tavily/core" const tvly = tavily({ apiKey: process.env.BAZAARLINK_API_KEY, apiBaseURL: "https://api.bazaarlink.ai/v1" }) const response = await tvly.map("docs.tavily.com")

POST/v1/map

Autorisierung

Authorizationerforderlich

string · header

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

Body

urlerforderlich

string

Stamm-URL für die Karte; das Schema ist optional, zum Beispiel docs.tavily.com.

required; scheme optional

Example: "docs.tavily.com"

instructions

string

Discovery-Anweisungen in natürlicher Sprache; sie erhöhen die Mapping-Kosten auf 2 statt 1 Credit je 10 erfolgreiche Seiten.

Example: "Find Python SDK pages"

max_depth

integer

Maximale Mapping-Tiefe, 1 bis 5, Standard 1.

1-5; default: 1

Example: 1

max_breadth

integer

Maximale Anzahl verfolgter Links je Seite und Ebene, 1 bis 500, Standard 20.

1-500; default: 20

Example: 20

limit

integer

Gesamtzahl der Links bis zum Stopp; mindestens 1, Standard 50.

minimum: 1; default: 50

Example: 50

select_paths

string[]

Regex-Muster für Pfadauswahl; höchstens 50 Einträge, jedes Muster maximal 200 Zeichen.

max 50 entries; max 200 characters per regex

Example: ["^/docs/.*"]

select_domains

string[]

Regex-Muster für Domainauswahl; höchstens 50 Einträge, jedes Muster maximal 200 Zeichen.

max 50 entries; max 200 characters per regex

Example: ["^docs\.example\.com$"]

exclude_paths

string[]

Regex-Muster für Pfadausschluss; höchstens 50 Einträge, jedes Muster maximal 200 Zeichen.

max 50 entries; max 200 characters per regex

Example: ["^/private/.*"]

exclude_domains

string[]

Regex-Muster für Domänenausschluss; höchstens 50 Einträge, jedes Muster maximal 200 Zeichen.

max 50 entries; max 200 characters per regex

Example: ["^private\.example\.com$"]

allow_external

boolean

Ob Links externer Domains in die Ergebnisse aufgenommen werden; Standard true.

default: true

Example: true

timeout

number

Wartezeit für die Karte in Sekunden. Tavily erlaubt 10–150, BazaarLinks effektives Maximum ist 90; höhere Werte werden auf 90 gesenkt.

Tavily: 10-150; BazaarLink default/effective maximum: 90 seconds; values above 90 are lowered to 90

Example: 90

include_usage

boolean

Ob usage in der Antwort enthalten ist; Standard false, mit credits und usage.cost bei true.

default: false

Example: false

POST /v1/map

1
2
3
4
5
6
7
curl https://api.bazaarlink.ai/v1/map   -H "Authorization: Bearer $BAZAARLINK_API_KEY"   -H "Content-Type: application/json"   -d '{
    "url": "docs.tavily.com",
    "instructions": "Find Python SDK pages",
    "limit": 20,
    "timeout": 90,
    "include_usage": true
  }'

Antwortbeispiele

Mapping abgeschlossen. results enthält gefundene URL-Strings; je 10 erfolgreiche Seiten kostet es 1 Credit, mit instructions 2 Credits.

1
2
3
4
5
6
7
8
9
10
11
12
13
{
  "base_url": "docs.tavily.com",
  "results": [
    "https://docs.tavily.com/welcome",
    "https://docs.tavily.com/documentation/api-credits"
  ],
  "response_time": 1.23,
  "usage": {
    "credits": 1,
    "cost": 0.01
  },
  "request_id": "map_123e4567-e89b-12d3-a456-426614174111"
}