Automatiza la extracción de leads de Google Maps con la API REST, o conecta directamente tus asistentes de IA mediante el servidor MCP.
Genera tu primera clave API en Ajustes y comienza a extraer datos en minutos.
curl https://www.basedonb.com/api/v1/account \
-H "Authorization: Bearer bdb_live_YOUR_KEY_HERE"Todas las solicitudes de API (excepto GET /health) requieren una clave API. Genera una desde Settings → API Keys.
Pasa tu clave de una de dos maneras:
Cabecera Authorization (recomendado)
Authorization: Bearer bdb_live_...
Cabecera X-API-Key
X-API-Key: bdb_live_...
https://www.basedonb.com/api/v1
100 solicitudes / minuto por clave API. Superarlo devuelve 429.
Busca los valores de país / estado / ciudad aceptados por la API de Scrapes. Los estados siguen el formato de código con puntos de GeoNames (US.CA, TR.34, DE.BE). Los países sin subdivisión devuelven un array states vacío — envía esos trabajos solo con country.
Los webhooks entregan notificaciones de eventos en tiempo real a tu endpoint. Cada solicitud incluye una cabecera X-Webhook-Signature para verificación.
Ejemplo de carga útil scrape.done entregada a tu endpoint:
POST https://your-server.com/webhook
Content-Type: application/json
X-Webhook-Signature: sha256=abc123...
X-Event-Type: scrape.done
User-Agent: BasedOnB-Webhook/1.0
{
"event": "scrape.done",
"created_at": "2026-01-15T10:05:00Z",
"data": {
"scrape_id": "job-uuid",
"query": "restaurants",
"city": "Istanbul",
"country": "TR",
"state": "TR.34",
"state_name": "İstanbul",
"leads_found": 47,
"credits_charged": 47
}
}Verifica la cabecera X-Webhook-Signature para asegurarte de que las solicitudes provienen de BasedOnB. Encuentra tu secreto de webhook en Ajustes → Webhooks.
import { createHmac } from "crypto";
function verifyWebhook(body: string, signature: string, secret: string): boolean {
const expected = "sha256=" + createHmac("sha256", secret).update(body).digest("hex");
return expected === signature;
}
// In your endpoint handler:
const body = await req.text();
const sig = req.headers.get("X-Webhook-Signature") ?? "";
if (!verifyWebhook(body, sig, process.env.WEBHOOK_SECRET!)) {
return new Response("Unauthorized", { status: 401 });
}| Estado HTTP | Código | Descripción |
|---|---|---|
| 401 | unauthorized | Missing or invalid API key |
| 403 | forbidden | API key valid but not allowed for this resource |
| 404 | not_found | Resource not found |
| 400 | bad_request | Invalid request parameters |
| 402 | insufficient_credits | Not enough credits to start a scrape |
| 429 | rate_limited | Too many open scrape jobs (max 3) or too many open target leads (max 5000). Wait for jobs to finish. |
| 500 | internal_error | Unexpected server error |
Formato de respuesta de error:
{
"error": {
"code": "insufficient_credits",
"message": "Not enough credits. You have 3 but need 50."
}
}basedonb'a Claude.ai, ChatGPT veya n8n gibi platformlardan tek tıkla yetki ver. API anahtarı yapıştırmaya gerek yok — OAuth 2.1 + PKCE ile güvenli, refresh tokenları arka planda çalışır, dilediğin zaman dashboard'dan iptal edebilirsin.
https://basedonb.com/api/mcphttps://basedonb.com/api/mcp.ChatGPT'nin custom connector özelliği aynı MCP URL'ini kabul eder.
https://basedonb.com/api/mcp.n8n'in dahili MCP Clientnode'unu kullan.
https://basedonb.com/api/mcp.Conecta BasedOnB con Claude, Cursor, Windsurf o cualquier cliente de IA compatible con MCP. La misma clave API, los mismos créditos, la misma superficie v1 — expuesta como 10 herramientas que la IA puede invocar directamente.
OAuth desteklemeyen yerel istemciler (Claude Code, Claude Desktop, Cursor) için config dosyasına MCP URL + uzun ömürlü API key gir. API anahtarını API & Webhooks sayfasından oluşturabilirsin.
Elige tu cliente y copia el snippet. Reemplaza la clave de marcador por la tuya.
claude mcp add basedonb https://www.basedonb.com/api/mcp \
--transport http \
--header "Authorization: Bearer bdb_live_xxxxxxxxxxxxxxxxx"Ejecuta esto en cualquier terminal. MCP estará disponible en todas las sesiones de Claude Code.
Todas las herramientas MCP se autentican con la misma clave bdb_live_… que la API REST. Pásala mediante el encabezado Authorization: Bearer del transporte MCP.
MCP endpoint çift kimlik doğrulama destekler:
Authorization: Bearer eyJ...Authorization: Bearer bdb_live_...basedonb, OAuth 2.1 + PKCE + Dynamic Client Registration (RFC 7591) + Authorization Server Metadata (RFC 8414) standartlarını uygular.
GET /.well-known/oauth-protected-resource — RFC 9728 resource metadata.GET /.well-known/oauth-authorization-server — RFC 8414 AS metadata.POST /oauth/register — Dynamic Client Registration (açık, PKCE-only public client).GET /oauth/authorize — Login + consent; redirect_uri'ye ?code=…&state=… ile döner.POST /oauth/token — Code → access & refresh tokens; refresh rotation aktif.POST /oauth/revoke — RFC 7009 refresh token revocation.Access token JWT (HS256, 1 saat TTL). Refresh token opaque, her kullanımda rotate olur ve chain'e bağlıdır — leak şüphesi tespit edilirse tüm chain revoke edilir.