BazaarLinkBazaarLink
ログイン
ドキュメントAPIリファレンスSDKリファレンスエージェント利用AIスキル
ウェブ検索

ウェブ検索

Tavily 互換の `POST /v1/search` は、言語モデルを呼び出さずにランキング済み結果を返します。`Authorization: Bearer <BazaarLink key>` または JSON body の `api_key` で認証します。ベース URL は `https://api.bazaarlink.ai/v1`、完全サポートされる旧入口は `https://bazaarlink.ai/api/v1` です。frozen OpenAPI の全フィールドを検証し、不明なフィールドは無視します。検索深度、日付、言語、ドメイン、画像、回答、raw content のオプションは以下の契約に従います。無料枠にはメール確認が必要で、毎日 00:00 UTC にリセットされます。残高なしのアカウントと残高ありのアカウントで枠が異なり、現在の N/M はデータベースの `getPublicFreeSearchAllowance()` から提供されます。現在の 1 日の枠は pricing page を確認してください。無料枠を使い切り残高がない場合は 432 です。顧客価格は credit 数に admin 設定の 1 credit あたりの価格を掛けたものです。ドル価格はハードコードせず、pricing page と各レスポンスの `usage.cost` を参照してください。Python は `TavilyClient(api_key=..., api_base_url='https://api.bazaarlink.ai/v1')`、JavaScript は `tavily({ apiKey, apiBaseURL })`、LangChain は `TavilySearch(api_base_url=...)` を使います。

POST/v1/search

認証

Authorization必須
string · header

Authorization ヘッダーに Bearer トークンとして API キーを渡します。

Body

query必須
string

実行する検索クエリ。

required; non-empty search query
Example: who is Leo Messi?
search_depth
string

遅延、関連性、結果コンテンツの生成方法を制御します。既定値は `basic`。`basic`、`fast`、`ultra-fast` は各 1 credit、`advanced` は 2 credits です。

default: basic
advancedbasicfastultra-fast
chunks_per_source
integer

ソースごとの関連コンテンツ断片の最大数。既定値は 3、範囲は 1–3。`advanced`、`basic`、`fast` で利用できます。

default: 3; 1..3
max_results
integer

返す検索結果の最大数。既定値は 10、許可範囲は 0–20 です。

default: 10; 0..20
Example: 1
topic
string

検索トピック。既定値は `general`。最新ニュースには `news`、金融コンテンツには `finance` を使います。

default: general
generalnewsfinance
time_range
string

公開日または更新日で絞り込みます。既定値は未設定。`day`、`week`、`month`、`year`、`d`、`w`、`m`、`y` が使えます。

default: null
dayweekmonthyeardwmy
start_date
string

この日付より後に公開または更新された結果を返します。形式: YYYY-MM-DD。

default: null; format YYYY-MM-DD
Example: 2025-02-09
end_date
string

この日付より前に公開または更新された結果を返します。形式: YYYY-MM-DD。

default: null; format YYYY-MM-DD
Example: 2025-12-29
include_published_date
boolean

各結果に推定公開日または更新日を含めます。`news` トピックでは自動的に有効になります。既定値は `false` です。

default: false
filter_by_published_date
boolean

`time_range`、`start_date`、`end_date` の範囲外、または日付を検出できない結果を除外します。既定値は `false`。`true` にすると `include_published_date` も有効になります。

default: false
include_answer
boolean | string

クエリに対する LLM 生成回答を含めます。既定値は `false`。boolean または `basic`/`advanced` を受け付けます。

default: false
basicadvanced
include_raw_content
boolean | string

各結果のクリーニング済み HTML コンテンツを含めます。既定値は `false`。boolean または `markdown`/`text` を受け付けます。

default: false
markdowntext
include_images
boolean

クエリ関連画像をトップレベルに、各結果のソース画像を結果内に含めます。既定値は `false` です。

default: false
include_image_descriptions
boolean

`include_images` が `true` のとき、各画像に説明を追加します。既定値は `false` です。

default: false
include_favicon
boolean

各結果に favicon URL を含めるかどうか。既定値は `false` です。

default: false
include_domains
string[]

指定したドメインに結果を限定します。最大 300 ドメイン。既定値は空配列です。

default: []; maximum 300 items
exclude_domains
string[]

指定したドメインの結果を除外します。最大 150 ドメイン。既定値は空配列です。

default: []; maximum 150 items
include_domains_mode
string

`include_domains` の適用方法を制御します。`restrict` は指定ドメインだけに限定し、`prefer` は優先しますが他のドメインも返せます。`include_domains` が必要で、なければ 400 です。既定値は未設定です。

default: null; requires include_domains
restrictprefer
country
string

指定国の結果を優先します。`topic` が `general` の場合のみ利用できます。既定値は未設定です。

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

指定言語の結果を優先します。ISO 639-1 コードまたは英語の言語名を受け付けます。既定値は未設定です。

default: null
Example: en
filter_by_language
boolean

`language` に一致しない結果を厳密に除外します。`language` が必要で、なければ 400 です。既定値は `false` です。

default: false; requires language
auto_parameters
boolean

クエリの意図から検索パラメータを自動設定します。明示値が優先され、`include_answer`、`include_raw_content`、`max_results` は手動指定が必要です。1 リクエストにつき 2 credits が加算されます。既定値は `false` です。

default: false; costs 2 credits
exact_match
boolean

クエリ内の引用句を含む結果だけを返し、同義語や意味的変形を避けます。既定値は `false` です。

default: false
include_usage
boolean

レスポンスに credit 使用量を含めるかどうか。既定値は `false` です。

default: false
safe_search
boolean

成人向けまたは安全でないコンテンツを除外します。既定値は `false`。`fast` と `ultra-fast` ではサポートされません。

default: false; unsupported for fast and ultra-fast
api_key
string

任意の JSON body 認証フィールド。Bearer ヘッダーがない場合は BazaarLink API key を指定できます。検証と転送の前に削除されます。

days
integer

SDK 互換用フィールド `days`。互換性のため受け付けます。計画に従い互換層で転送または無視され、frozen OpenAPI のフィールドではありません。

max_hours
integer

SDK 互換用フィールド `max_hours`。互換性のため受け付けます。計画に従い互換層で転送または無視され、frozen OpenAPI のフィールドではありません。

fetch_timeout
number

SDK 互換用フィールド `fetch_timeout`。互換性のため受け付けます。計画に従い互換層で転送または無視され、frozen OpenAPI のフィールドではありません。

cache_fallback
boolean

SDK 互換用フィールド `cache_fallback`。互換性のため受け付けます。計画に従い互換層で転送または無視され、frozen OpenAPI のフィールドではありません。

timeout
number

SDK 互換用の `timeout` フィールド。互換性のため受け付けます。検索はサービス側の timeout を使い、不明または未対応のフィールドは無視されます。

POST /v1/search
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"
  }'
レスポンス例

成功レスポンスには `query`、任意の `answer`、トップレベルの `images`、`title`・`url`・`content`・`score` と任意の `raw_content`・`published_date`・`favicon`・`images`・`id` を持つ `results`、任意の `auto_parameters`、`response_time`、`credits` と追加の `cost` を含む `usage`、`request_id` が含まれます。`usage.cost` は顧客に請求する USD 価格で COGS ではありません。`request_id` は BazaarLink が生成する ID です。

{
  "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"
}
サポート
サポート
こんにちは。どのようなご用件でしょうか？
メッセージをお送りください。担当者より返信します。