Websuche — BazaarLink API

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

Websuche

Die Tavily-kompatible `POST /v1/search`-Route liefert sortierte Ergebnisse, ohne ein Sprachmodell aufzurufen. Authentifizieren Sie mit `Authorization: Bearer <BazaarLink key>` oder `api_key` im JSON-Body. Verwenden Sie `https://api.bazaarlink.ai/v1` oder die vollständig unterstützte Basis-URL `https://bazaarlink.ai/api/v1`. Alle eingefrorenen OpenAPI-Felder werden validiert; unbekannte Felder werden ignoriert. Optionen für Suchtiefe, Datum, Sprache, Domains, Bilder, Antworten und Rohinhalt folgen dem untenstehenden Vertrag. Das kostenlose Kontingent erfordert eine verifizierte E-Mail und wird täglich um 00:00 UTC zurückgesetzt; Konten ohne Guthaben und aufgeladene Konten haben unterschiedliche Kontingente. Die aktuellen N/M-Werte kommen aus der Datenbank über `getPublicFreeSearchAllowance()`; das aktuelle Tageskontingent steht auf der pricing page. Wenn das kostenlose Kontingent verbraucht und kein Guthaben vorhanden ist, wird 432 zurückgegeben. Der Kundenpreis ist die Credit-Anzahl multipliziert mit dem vom Admin konfigurierten Preis pro Credit. Es wird kein Dollarpreis fest einprogrammiert; siehe pricing page und `usage.cost` jeder Antwort. Python: `TavilyClient(api_key=..., api_base_url='https://api.bazaarlink.ai/v1')`; JavaScript: `tavily({ apiKey, apiBaseURL })`; LangChain: `TavilySearch(api_base_url=...)`.

POST/v1/search

Autorisierung

Authorizationerforderlich

string · header

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

Body

queryerforderlich

string

Die auszuführende Suchanfrage.

required; non-empty search query

Example: who is Leo Messi?

search_depth

string

Steuert Latenz, Relevanz und die Erstellung des Ergebnisinhalts. Standard: `basic`; `basic`, `fast` und `ultra-fast` kosten jeweils 1 Credit, `advanced` 2 Credits.

default: basic

advancedbasicfastultra-fast

chunks_per_source

integer

Maximale Anzahl relevanter Inhaltsabschnitte pro Quelle. Standard: 3; Bereich: 1–3. Verfügbar für `advanced`, `basic` und `fast`.

default: 3; 1..3

max_results

integer

Maximale Anzahl der zurückzugebenden Suchergebnisse. Standard: 10; zulässiger Bereich: 0–20.

default: 10; 0..20

Example: 1

topic

string

Suchthema. Standard: `general`; verwenden Sie `news` für aktuelle Nachrichten und `finance` für Finanzinhalte.

default: general

generalnewsfinance

time_range

string

Filtert nach Veröffentlichungs- oder Aktualisierungsdatum. Standard: nicht gesetzt. Zulässige Werte: `day`, `week`, `month`, `year`, `d`, `w`, `m`, `y`.

default: null

dayweekmonthyeardwmy

start_date

string

Gibt Ergebnisse zurück, die nach diesem Datum veröffentlicht oder aktualisiert wurden. Format: YYYY-MM-DD.

default: null; format YYYY-MM-DD

Example: 2025-02-09

end_date

string

Gibt Ergebnisse zurück, die vor diesem Datum veröffentlicht oder aktualisiert wurden. Format: YYYY-MM-DD.

default: null; format YYYY-MM-DD

Example: 2025-12-29

include_published_date

boolean

Fügt jedem Ergebnis das geschätzte Veröffentlichungs- oder Aktualisierungsdatum hinzu. Für das Thema `news` automatisch aktiviert. Standard: `false`.

default: false

filter_by_published_date

boolean

Entfernt Ergebnisse außerhalb des Fensters aus `time_range`, `start_date` oder `end_date`, einschließlich Ergebnissen ohne erkennbares Datum. Standard: `false`; `true` aktiviert auch `include_published_date`.

default: false

include_answer

boolean | string

Fügt eine von einem LLM erzeugte Antwort hinzu. Standard: `false`; akzeptiert boolean oder `basic`/`advanced`.

default: false

basicadvanced

include_raw_content

boolean | string

Fügt bereinigten HTML-Inhalt für jedes Ergebnis hinzu. Standard: `false`; akzeptiert boolean oder `markdown`/`text`.

default: false

markdowntext

include_images

boolean

Fügt querybezogene Bilder auf oberster Ebene und Quellbilder in jedem Ergebnis hinzu. Standard: `false`.

default: false

include_image_descriptions

boolean

Fügt bei `include_images: true` eine Beschreibung zu jedem Bild hinzu. Standard: `false`.

default: false

include_favicon

boolean

Ob eine Favicon-URL für jedes Ergebnis enthalten ist. Standard: `false`.

default: false

include_domains

string[]

Beschränkt Ergebnisse auf die aufgeführten Domains; maximal 300 Domains. Standard: leeres Array.

default: []; maximum 300 items

exclude_domains

string[]

Schließt Ergebnisse der aufgeführten Domains aus; maximal 150 Domains. Standard: leeres Array.

default: []; maximum 150 items

include_domains_mode

string

Steuert die Anwendung von `include_domains`. `restrict` beschränkt Ergebnisse auf diese Domains; `prefer` priorisiert sie, kann aber andere zurückgeben. `include_domains` ist erforderlich, sonst 400. Standard: nicht gesetzt.

default: null; requires include_domains

restrictprefer

country

string

Bevorzugt Ergebnisse aus einem ausgewählten Land. Nur verfügbar, wenn `topic` `general` ist. Standard: nicht gesetzt.

default: null; only when topic is general

afghanistanalbaniaalgeriaandorraangolaargentinaarmeniaaustraliaaustriaazerbaijanbahamasbahrainbangladeshbarbadosbelarusbelgiumbelizebeninbhutanboliviabosnia and herzegovinabotswanabrazilbruneibulgariaburkina fasoburundicambodiacamerooncanadacape verdecentral african republicchadchilechinacolombiacomoroscongocosta ricacroatiacubacyprusczech republicdenmarkdjiboutidominican republicecuadoregyptel salvadorequatorial guineaeritreaestoniaethiopiafijifinlandfrancegabongambiageorgiagermanyghanagreeceguatemalaguineahaitihondurashungaryicelandindiaindonesiairaniraqirelandisraelitalyjamaicajapanjordankazakhstankenyakuwaitkyrgyzstanlatvialebanonlesotholiberialibyaliechtensteinlithuanialuxembourgmadagascarmalawimalaysiamaldivesmalimaltamauritaniamauritiusmexicomoldovamonacomongoliamontenegromoroccomozambiquemyanmarnamibianepalnetherlandsnew zealandnicaraguanigernigerianorth koreanorth macedonianorwayomanpakistanpanamapapua new guineaparaguayperuphilippinespolandportugalqatarromaniarussiarwandasaudi arabiasenegalserbiasingaporeslovakiasloveniasomaliasouth africasouth koreasouth sudanspainsri lankasudanswedenswitzerlandsyriataiwantajikistantanzaniathailandtogotrinidad and tobagotunisiaturkeyturkmenistanugandaukraineunited arab emiratesunited kingdomunited statesuruguayuzbekistanvenezuelavietnamyemenzambiazimbabwe

language

string

Bevorzugt Ergebnisse in einer ausgewählten Sprache. Akzeptiert einen ISO-639-1-Code oder einen englischen Sprachnamen. Standard: nicht gesetzt.

default: null

Example: en

filter_by_language

boolean

Entfernt Ergebnisse, die nicht zu `language` passen, strikt. Erfordert `language`, sonst 400. Standard: `false`.

default: false; requires language

auto_parameters

boolean

Wählt Suchparameter automatisch aus der Abfrageabsicht. Explizite Werte haben Vorrang; `include_answer`, `include_raw_content` und `max_results` müssen manuell gesetzt werden. Kostet zusätzlich 2 Credits pro Anfrage. Standard: `false`.

default: false; costs 2 credits

exact_match

boolean

Gibt nur Ergebnisse zurück, die zitierte Ausdrücke aus der Anfrage enthalten, und umgeht Synonyme sowie semantische Varianten. Standard: `false`.

default: false

include_usage

boolean

Gibt an, ob der Credit-Verbrauch in der Antwort enthalten ist. Standard: `false`.

default: false

safe_search

boolean

Filtert Inhalte für Erwachsene oder unsichere Inhalte. Standard: `false`; nicht unterstützt für `fast` und `ultra-fast`.

default: false; unsupported for fast and ultra-fast

api_key

string

Optionales Authentifizierungsfeld im JSON-Body. Wenn kein Bearer-Header vorhanden ist, kann hier der BazaarLink-API-Key stehen; vor Validierung und Weiterleitung wird er entfernt.

days

integer

SDK-Kompatibilitätsfeld `days`. Wird aus Kompatibilitätsgründen akzeptiert; laut Plan kann es durchgereicht oder ignoriert werden und gehört nicht zum eingefrorenen OpenAPI-Schema.

max_hours

integer

SDK-Kompatibilitätsfeld `max_hours`. Wird aus Kompatibilitätsgründen akzeptiert; laut Plan kann es durchgereicht oder ignoriert werden und gehört nicht zum eingefrorenen OpenAPI-Schema.

fetch_timeout

number

SDK-Kompatibilitätsfeld `fetch_timeout`. Wird aus Kompatibilitätsgründen akzeptiert; laut Plan kann es durchgereicht oder ignoriert werden und gehört nicht zum eingefrorenen OpenAPI-Schema.

cache_fallback

boolean

SDK-Kompatibilitätsfeld `cache_fallback`. Wird aus Kompatibilitätsgründen akzeptiert; laut Plan kann es durchgereicht oder ignoriert werden und gehört nicht zum eingefrorenen OpenAPI-Schema.

timeout

number

SDK-kompatibles Feld `timeout`. Wird aus Kompatibilitätsgründen akzeptiert; die Suche verwendet das serverseitige Timeout, unbekannte oder nicht unterstützte Felder werden ignoriert.

POST /v1/search

1
2
3
4
5
6
7
8
9
10
curl https://api.bazaarlink.ai/v1/search \
  -H "Authorization: Bearer $BAZAARLINK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "latest news on open-source language models",
    "search_depth": "basic",
    "max_results": 5,
    "topic": "news",
    "time_range": "week"
  }'

Antwortbeispiele

Eine erfolgreiche Antwort enthält `query`, optional `answer`, `images` auf oberster Ebene, `results` (jeweils mit `title`, `url`, `content`, `score` und optional `raw_content`, `published_date`, `favicon`, `images`, `id`), optional `auto_parameters`, `response_time`, `usage` (mit `credits` und unserem zusätzlichen `cost`) sowie `request_id`. `usage.cost` ist der dem Kunden berechnete USD-Preis, niemals COGS; `request_id` wird von BazaarLink für den Support erzeugt.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
{
  "query": "Who is Leo Messi?",
  "answer": "Lionel Messi is an Argentine footballer.",
  "images": [
    {
      "url": "https://example.com/messi.jpg",
      "description": "Lionel Messi"
    }
  ],
  "results": [
    {
      "title": "Lionel Messi Facts | Britannica",
      "url": "https://www.britannica.com/facts/Lionel-Messi",
      "content": "Lionel Messi is an Argentine footballer.",
      "score": 0.81025416,
      "raw_content": null,
      "published_date": "Tue, 11 Mar 2025 17:00:00 GMT",
      "favicon": "https://britannica.com/favicon.png",
      "images": [
        {
          "url": "https://example.com/messi.jpg",
          "description": "Lionel Messi"
        }
      ],
      "id": "a3f9c2-04"
    }
  ],
  "auto_parameters": {
    "topic": "general",
    "search_depth": "basic"
  },
  "response_time": 1.67,
  "usage": {
    "credits": 1,
    "cost": "<customer_price_usd>"
  },
  "request_id": "123e4567-e89b-12d3-a456-426614174111"
}