ドキュメント APIリファレンス SDKリファレンスエージェント利用 AIスキル

ウェブ検索

ウェブページをクロール

ルート URL からウェブサイトのリンクグラフを探索し、成功したページの内容を抽出します。Bearer API キー、または互換性のため JSON body の api_key を使えます。https://api.bazaarlink.ai/v1 と https://bazaarlink.ai/api/v1 の両方に対応します。未知のフィールドは無視されます。レスポンスには成功したページ、response_time、usage.credits、管理者設定の credit 単価を掛けた追加フィールド usage.cost、request_id が含まれます。Tavily の timeout は 10～150 秒ですが、BazaarLink の有効上限は 90 秒です。90 を超える値は 90 に下げ、100 秒のエッジ制限未満に保ちます。料金は mapping コストと extraction コストの合計です。basic の成功ページ 10 件は 1 + 2 = 3 credits、advanced extraction は extraction 部分を、instructions は mapping 部分を 2 倍にします。失敗ページは無料です。実際の credits は共通の日次無料枠から引かれます。limit からの見積りが残りを超える場合、超過分は残高から請求され、残高がなければ 432 を返して limit を下げるよう案内します。 SDK の例です。キーは環境変数など安全なサーバー側設定に保存してください。 Python: from tavily import TavilyClient client = TavilyClient(api_key="...", api_base_url="https://api.bazaarlink.ai/v1") response = client.crawl("docs.tavily.com", instructions="Find Python SDK pages") 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.crawl("docs.tavily.com", { instructions: "Find Python SDK pages" }) LangChain (crawl only): from langchain_tavily import TavilyCrawl tool = TavilyCrawl(api_key="...", api_base_url="https://api.bazaarlink.ai/v1") response = tool.invoke({"url": "docs.tavily.com", "instructions": "Find Python SDK pages"})

POST/v1/crawl

認証

Authorization必須

string · header

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

Body

url必須

string

クロールを開始するルート URL。scheme は省略でき、例は docs.tavily.com です。

required; scheme optional

Example: "docs.tavily.com"

instructions

string

クロールへの自然言語指示。指定すると chunks_per_source が使え、成功ページ 10 件ごとの mapping 部分が 2 credits になります。

Example: "Find Python SDK pages"

chunks_per_source

integer

ソースごとの短いコンテンツチャンク数。instructions 指定時のみ使用でき、1～5、既定値は 3 です。

1-5; only with instructions; default: 3

Example: 3

max_depth

integer

クロールの最大深度。1～5、既定値は 1 です。

1-5; default: 1

Example: 1

max_breadth

integer

各レベルで 1 ページあたりに追跡するリンク数。1～500、既定値 20 です。

1-500; default: 20

Example: 20

limit

integer

停止するまでに処理するリンクの総数。最小 1、既定値 50 です。

minimum: 1; default: 50

Example: 50

select_paths

string[]

パス選択用の正規表現配列です。最大 50 件、各パターンは 200 文字までです。

max 50 entries; max 200 characters per regex

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

select_domains

string[]

ドメイン選択用の正規表現配列です。最大 50 件、各パターンは 200 文字までです。

max 50 entries; max 200 characters per regex

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

exclude_paths

string[]

パス除外用の正規表現配列です。最大 50 件、各パターンは 200 文字までです。

max 50 entries; max 200 characters per regex

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

exclude_domains

string[]

ドメイン除外用の正規表現配列です。最大 50 件、各パターンは 200 文字までです。

max 50 entries; max 200 characters per regex

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

allow_external

boolean

外部ドメインのリンクを最終結果に含めるか。既定値は true です。

default: true

Example: true

include_images

boolean

ページから抽出した画像を含めるか。既定値は false です。

default: false

Example: false

extract_depth

string

抽出の深度。advanced は表や埋め込みコンテンツを多く扱い、成功ページ 5 件ごとの抽出部分の credit を 2 倍にします。

default: basic

basicadvanced

Example: "basic"

format

string

抽出ページの形式。markdown または text、既定値は markdown です。

default: markdown

markdowntext

Example: "markdown"

include_favicon

boolean

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

default: false

Example: false

timeout

number

クロールを待つ秒数。Tavily は 10～150 ですが、BazaarLink の有効上限は 90 秒で、90 を超える値は 90 に下げられます。

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

Example: 90

include_usage

boolean

レスポンスに usage を含めるか。既定値は false で、含めると credits と usage.cost が表示されます。

default: false

Example: false

POST /v1/crawl

1
2
3
4
5
6
7
curl https://api.bazaarlink.ai/v1/crawl   -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
  }'

レスポンス例

クロールが完了しました。results は成功したページのみを含み、usage.credits は実際の credit、usage.cost は管理者設定の単価による顧客価格です。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
{
  "base_url": "docs.tavily.com",
  "results": [
    {
      "url": "https://docs.tavily.com/welcome",
      "raw_content": "Welcome to the docs",
      "favicon": "https://docs.tavily.com/favicon.ico"
    }
  ],
  "response_time": 1.23,
  "usage": {
    "credits": 3,
    "cost": 0.03
  },
  "request_id": "crawl_123e4567-e89b-12d3-a456-426614174111"
}