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

Websuche

Webinhalte extrahieren

Extrahiert rohe Webinhalte aus einer URL oder aus einer Gruppe von bis zu 20 URLs. Erfolgreiche URLs stehen in results, Fehler pro URL in failed_results; auch bei HTTP 200 mit einem leeren results-Array müssen beide Arrays geprüft werden. Die Ausgabereihenfolge ist nicht garantiert. Unterstützt werden query-Reranking, 1–5 Chunks pro Quelle (nur mit query), basic- oder advanced-Extraktion, Bilder, Favicons, das Format markdown oder text sowie ein Timeout von 1–60 Sekunden. Unbekannte Anfragefelder werden ignoriert. Verwenden Sie Authorization: Bearer <key> oder als Tavily-kompatiblen Fallback api_key im JSON-Body. Beide BazaarLink-Base-URLs werden unterstützt: https://api.bazaarlink.ai/v1 und https://bazaarlink.ai/api/v1. Je 5 erfolgreiche URL-Extraktionen kosten basic 1 Credit oder advanced 2 Credits; fehlgeschlagene URLs sind kostenlos. Der Kundenpreis ergibt sich aus Credits multipliziert mit dem vom Administrator festgelegten Preis pro Credit. Maßgeblich sind die BazaarLink pricing page und usage.cost in der Antwort. Das kostenlose Kontingent teilt sich die täglichen Credits mit search; ist es ohne Guthaben aufgebraucht, wird 432 zurückgegeben. cURL: `curl https://api.bazaarlink.ai/v1/extract -H "Authorization: Bearer $BAZAARLINK_API_KEY" -H "Content-Type: application/json" -d '{"urls":["https://example.com/article"]}'` Python: `TavilyClient(api_key=..., api_base_url="https://api.bazaarlink.ai/v1").extract(urls=[...])` JavaScript: `tavily({ apiKey, apiBaseURL })` LangChain: `TavilyExtract(api_base_url=...)`

POST/v1/extract

Autorisierung

Authorizationerforderlich

string · header

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

Body

urlserforderlich

string | string[]

Die zu extrahierenden URLs. Übergeben Sie einen einzelnen String oder ein Array mit 1–20 URLs. Ein leeres Array oder keine gültige URL liefert 400.

string or array of 1–20 URLs

Example: ["https://example.com/article"]

query

string

Die Benutzerabsicht zum erneuten Rangordnen extrahierter Inhalts-Chunks.

Example: "key findings"

chunks_per_source

integer

Maximale Anzahl relevanter Inhalts-Chunks pro Quelle. Muss 1–5 sein und ist nur mit query verfügbar.

1–5; only with query

Example: 3

extract_depth

string

Extraktionstiefe. advanced kann Tabellen und eingebettete Inhalte mit höherer Latenz abrufen; basic kostet je 5 erfolgreiche URLs 1 Credit, advanced 2 Credits.

default: basic

basicadvanced

Example: "basic"

include_images

boolean

Gibt an, ob aus jeder erfolgreichen Seite extrahierte Bild-URLs enthalten sein sollen.

default: false

Example: true

include_favicon

boolean

Gibt an, ob die Favicon-URL in jedem erfolgreichen Ergebnis enthalten sein soll.

default: false

Example: true

format

string

Format der extrahierten Inhalte. markdown bewahrt die Markdown-Struktur, text liefert reinen Text.

default: markdown

markdowntext

Example: "markdown"

timeout

number

Maximale Wartezeit für die Extraktion in Sekunden, 1–60. Ohne Angabe sind es 10 Sekunden für basic und 30 Sekunden für advanced.

1–60 seconds; default depends on extract_depth

Example: 30

include_usage

boolean

Gibt an, ob Credits und usage.cost in der Antwort enthalten sein sollen.

default: false

Example: true

POST /v1/extract

1
2
3
4
5
6
7
8
9
10
11
12
13
14
curl https://api.bazaarlink.ai/v1/extract \
  -H "Authorization: Bearer $BAZAARLINK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "urls": ["https://example.com/article", "https://example.org/docs"],
    "query": "key findings",
    "chunks_per_source": 3,
    "extract_depth": "basic",
    "include_images": true,
    "include_favicon": true,
    "format": "markdown",
    "timeout": 30,
    "include_usage": true
  }'

Antwortbeispiele

Die Extraktion ist abgeschlossen. Prüfen Sie results auf erfolgreiche Einträge und failed_results auf Fehler pro URL. HTTP 200 kann ein leeres results-Array enthalten, und die Ausgabereihenfolge ist nicht garantiert. usage.credits ist der Credit-Verbrauch; usage.cost ist der von BazaarLink berechnete USD-Kundenpreis, nicht der Upstream-Preis; request_id ist die von BazaarLink erzeugte Anfrage-ID.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
{
  "results": [
    {
      "url": "https://example.com/article",
      "raw_content": "Article content extracted as Markdown.",
      "images": [
        "https://example.com/image.jpg"
      ],
      "favicon": "https://example.com/favicon.ico"
    }
  ],
  "failed_results": [
    {
      "url": "https://example.org/unavailable",
      "error": "Failed to retrieve content"
    }
  ],
  "response_time": 0.42,
  "usage": {
    "credits": 1,
    "cost": 0
  },
  "request_id": "bl-extract-example-request"
}