Документация API Ссылка SDK Ссылка Агентное использование AI Навыки

Веб-поиск

Построение карты URL сайта

Исследуйте граф ссылок сайта от корневого URL и верните найденные URL. Это endpoint только для discovery, без полей извлечения содержимого. Используйте Bearer API-ключ или передайте api_key в JSON body как совместимый запасной вариант; поддерживаются обе базы URL. Неизвестные поля игнорируются. Ответ содержит base_url, массив строк URL в results, response_time, наши дополнительные usage.credits и usage.cost по цене за кредит, заданной администратором, а также request_id. Mapping стоит 1 credit за каждые 10 успешных страниц или 2 credits при указании instructions; неудачные страницы бесплатны. Фактические credits списываются из общей дневной бесплатной квоты. Если оценка по limit превышает остаток, превышение списывается с баланса, а без баланса возвращается 432 с рекомендацией уменьшить limit. Примеры SDK; храните ключ в переменной окружения или другой защищённой настройке на стороне сервера. 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

Авторизация

Authorizationобязательно

string · header

Ключ API как Bearer-токен в заголовке Authorization.

Тело

urlобязательно

string

Корневой URL для построения карты; схему можно не указывать, например docs.tavily.com.

required; scheme optional

Example: "docs.tavily.com"

instructions

string

Инструкции discovery на естественном языке; они повышают стоимость mapping до 2 credits вместо 1 за каждые 10 успешных страниц.

Example: "Find Python SDK pages"

max_depth

integer

Максимальная глубина построения карты: от 1 до 5, по умолчанию 1.

1-5; default: 1

Example: 1

max_breadth

integer

Максимум ссылок на страницу для каждого уровня: от 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

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/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
  }'

Примеры ответов

Построение карты завершено. results содержит найденные строки URL; каждые 10 успешных страниц стоят 1 credit, или 2 credits при указании instructions.

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"
}