Baza Получить ключ

Docs

Первый запрос к Baza за 5 минут

Минимальная документация для запуска: ключ, авторизация, endpoint, SDK и MCP-конфиг. Полная reference-версия будет расширяться вместе с каталогом баз.

Получить ключ Открыть Playground
quickstartcopy ready
curl https://api.baza.testplace.pro/v1/companies/7707083893 \
  -H "Authorization: Bearer bza_xxx"

# → JSON: name, status, source, updated_at, confidence

Quickstart

1. Получите ключ

Free tier даёт 1 000 запросов в месяц без карты. Для демо можно начать с Playground.

# pip install baza-sdk
from baza import Baza
client = Baza(api_key="bza_xxx")

Authentication

2. Передайте ключ в заголовке

Authorization: Bearer bza_xxx

Для MCP ключ кладётся в переменную окружения `BAZA_API_KEY`.

API Reference

3. Базовые endpoint

GET /v1/companies/{inn}Карточка компании, статус, источник и дата.
POST /v1/wb/niche-analysisОценка ниши WB по категории и ценовому диапазону.
POST /v1/tenders/searchПоиск закупок и краткая оценка релевантности.
GET /v1/databasesСписок баз, статус Live/Beta/Roadmap и доступность по тарифам.

SDK

4. Python и Node.js

import { Baza } from "@baza/sdk";
const baza = new Baza({ apiKey: process.env.BAZA_API_KEY });
const company = await baza.companies.get({ inn: "7707083893" });

MCP

5. Claude / Cursor config

{
  "mcpServers": {
    "baza": {
      "command": "npx",
      "args": ["-y", "@baza/mcp-server"],
      "env": { "BAZA_API_KEY": "bza_xxx" }
    }
  }
}

Errors & limits

6. Ошибки должны помогать агенту

КодЧто значитЧто делать агенту
query_too_broadНе хватает объекта, периода или категории.Уточнить вопрос.
database_unavailableБаза пока не доступна на тарифе.Предложить альтернативу или запросить доступ.
rate_limitedПревышен лимит запросов.Повторить позже или использовать кэш.