Шукайте контакти, прямо з вашого агента.

Огляд

API B2BLeads — це єдиний ендпоінт для пошуку, зручний для MCP. Базовий URL:

https://api.b2bleadsapi.com

Кожна відповідь у форматі JSON. SDK не потрібен — прості HTTPS-запити працюють з будь-якої мови програмування або через нативний виклик інструментів AI-агентом.

Автентифікація

Передавайте свій API-ключ як bearer-токен. Створюйте ключі в панелі керування в розділі API-ключі.

Authorization: Bearer b2bl-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Запити без дійсного ключа повертають 401 Unauthorized. Кожен ключ має обмеження за кількістю запитів на хвилину та обмежений місячною квотою пошуків згідно з вашим тарифом.

GET /v1/search-leads

Знаходить компанії за вашою власною зрозумілою термінологією пошуку — чіткі, цілеспрямовані параметри замість низькорівневих полів запиту. Потрібен хоча б один із параметрів q, industry або city.

Параметри запиту

Приклад запиту

curl "https://api.b2bleadsapi.com/v1/search-leads?industry=construction&city=Munich&radius_km=25&min_rating=4&has_website=true&open_now=true&rank_by=distance" \
  -H "Authorization: Bearer b2bl-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

Приклад відповіді

{
  "results": [
    {
      "id": "ChIJ...",
      "name": "Bauunion GmbH",
      "address": "Landsberger Str. 12, 80339 München",
      "phone": "+49 89 1234567",
      "website": "https://bauunion.de",
      "rating": 4.7,
      "ratingCount": 128,
      "status": "OPERATIONAL",
      "priceLevel": null,
      "openNow": true
    }
  ],
  "nextPageToken": "AY1v..."
}

Передайте nextPageToken назад як page_token, щоб отримати наступну сторінку. Він стає null, коли результатів більше немає.

Примітка для AI-агентів: на тарифах із Email Finder поле email збереженого контакту може повернутися як буквальний рядок CFD* замість адреси. Це означає, що кожна спроба збору даних (звичайний HTTP-запит, потім резервний варіант через headless-браузер) була заблокована захистом від ботів Cloudflare на цільовому сайті — це не порожній результат і не помилка, і повторна спроба на тому самому сайті не буде успішною. Сприймайте CFD* як "електронна адреса недоступна", а не як реальну адресу, і не показуйте це кінцевому користувачеві як його контактну електронну пошту.

Спробувати наживо

GET /v1/search-leads/industries

Публічний ендпоінт без автентифікації — повертає поточний перелік підтримуваних значень industry, щоб клієнтам і агентам ніколи не доводилося прописувати їх у коді.

curl "https://api.b2bleadsapi.com/v1/search-leads/industries"

{
  "industries": [
    { "value": "construction", "label": "Construction" },
    { "value": "restaurants", "label": "Restaurants" },
    { "value": "retail", "label": "Retail" },
    { "value": "manufacturing", "label": "Manufacturing" },
    { "value": "logistics", "label": "Logistics & Freight" },
    { "value": "it_services", "label": "IT Services" },
    { "value": "healthcare", "label": "Healthcare" },
    { "value": "real_estate", "label": "Real Estate" },
    { "value": "hospitality", "label": "Hospitality" },
    { "value": "professional_services", "label": "Professional Services" }
  ]
}

Спробувати наживо

Помилки

Помилки повертаються у вигляді простого JSON з одним полем error.

Ліміти запитів і квота

Кожен API-ключ має ліміт запитів на хвилину та місячну квоту пошуків, обидва визначаються вашим тарифом. Перевірити поточне використання можна в будь-який момент у розділі панелі керування Оплата або через ендпоінт GET /v1/billing, якщо ви автентифіковані токеном сесії.

Використання як MCP-інструмент

Ми публікуємо офіційний MCP-сервер, який обгортає цей API у п'ять інструментів — search_leads, list_industries, list_saved_lists, get_saved_list і find_email — для Claude Desktop, Claude Code, Cursor, ChatGPT, Gemini/Antigravity, Grok Build, GitHub Copilot та будь-якого іншого MCP-сумісного клієнта. Ручна інтеграція через REST не потрібна.

Додайте його до конфігурації вашого MCP-клієнта з API-ключем зі сторінки API-ключі:

{
  "mcpServers": {
    "b2bleads": {
      "command": "npx",
      "args": ["-y", "b2bleads-mcp"],
      "env": {
        "B2BLEADS_API_KEY": "your-api-key-here"
      }
    }
  }
}

Хочете підключити самостійно через звичайний REST? Наведені вище параметри напряму відповідають вхідній схемі інструмента — агент обирає галузь і місто звичайною мовою, а B2BLeads сам перетворює це на реальний пошуковий запит.

{
  "name": "search_leads",
  "description": "Find companies by industry, city and radius",
  "parameters": {
    "q": "string, optional free-text query",
    "industry": "enum, see /v1/search-leads/industries",
    "city": "string",
    "radius_km": "number, max 50",
    "min_rating": "number 0-5",
    "has_website": "boolean",
    "verified_only": "boolean",
    "open_now": "boolean",
    "price_level": "enum, comma-separated: budget, moderate, expensive, luxury",
    "rank_by": "enum: relevance, distance (requires city)",
    "limit": "number 1-20",
    "page_token": "string, from a previous response's nextPageToken"
  }
}

Окремий інструмент виконує вичерпний пошук по всьому місту — але з явним попередженням про підвищену вартість, щоб агенти не викликали його за замовчуванням:

{
  "name": "search_leads_advanced",
  "description": "⚠️ Elevated cost: 9x the quota of a single search_leads call. Tiles a city into a 3x3 grid of sub-searches to return up to ~180 deduplicated businesses in one city, beyond search_leads' normal ~20-60 result ceiling. Only use when more results are explicitly needed for one city — never as a default. Does not support pagination.",
  "parameters": {
    "q": "string, optional free-text query",
    "industry": "enum, see /v1/search-leads/industries",
    "city": "string, required — ONLY the city name, e.g. \"Lyon\" (not the full search query)",
    "min_rating": "number 0-5",
    "has_website": "boolean",
    "verified_only": "boolean",
    "open_now": "boolean",
    "price_level": "enum, comma-separated: budget, moderate, expensive, luxury"
  }
}

Додаткові інструменти лише для читання доповнюють MCP-набір:

{
  "name": "list_industries",
  "description": "List the industry values accepted by search_leads",
  "parameters": {}
}

{
  "name": "list_saved_lists",
  "description": "List this account's saved lead lists",
  "parameters": {}
}

{
  "name": "get_saved_list",
  "description": "Get the leads saved in a specific list",
  "parameters": {
    "list_id": "string, required — from list_saved_lists"
  }
}

{
  "name": "find_email",
  "description": "Look up a best-effort contact email for a single business website",
  "parameters": {
    "website": "string, required, e.g. https://example.com"
  }
}

find_email доступний на будь-якому платному тарифі (починаючи зі Starter) — на тому самому рівні, на якому search_leads вже автоматично збагачує результати електронними адресами. Без активного тарифу ключ отримає просту помилку "потрібне підвищення тарифу" замість результату.