Automatisieren Sie das Scraping von Google-Maps-Leads mit der REST-API oder verbinden Sie Ihre KI-Assistenten direkt über den MCP-Server.
Generieren Sie Ihren ersten API-Schlüssel in den Einstellungen und beginnen Sie in wenigen Minuten mit dem Scraping.
curl https://www.basedonb.com/api/v1/account \
-H "Authorization: Bearer bdb_live_YOUR_KEY_HERE"Alle API-Anfragen (außer GET /health) erfordern einen API-Schlüssel. Erstellen Sie einen über Settings → API Keys.
Übergeben Sie Ihren Schlüssel auf eine von zwei Arten:
Authorization-Header (empfohlen)
Authorization: Bearer bdb_live_...
X-API-Key-Header
X-API-Key: bdb_live_...
https://www.basedonb.com/api/v1
100 Anfragen / Minute pro API-Schlüssel. Eine Überschreitung gibt 429 zurück.
Suchen Sie die von der Scrapes-API akzeptierten Werte für Land / Bundesland / Stadt. Bundesländer folgen dem GeoNames-Punktcode-Format (US.CA, TR.34, DE.BE). Länder ohne Unterteilung geben ein leeres states-Array zurück — senden Sie diese Jobs nur mit country.
Webhooks liefern Echtzeit-Ereignisbenachrichtigungen an Ihren Endpunkt. Jede Anfrage enthält einen X-Webhook-Signature-Header zur Verifizierung.
Beispiel-scrape.done-Payload, die an Ihren Endpunkt geliefert wird:
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
}
}Verifizieren Sie den X-Webhook-Signature-Header, um sicherzustellen, dass Anfragen von BasedOnB stammen. Ihr Webhook-Secret finden Sie unter Einstellungen → 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 });
}| HTTP-Status | Code | Beschreibung |
|---|---|---|
| 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 |
Fehler-Antwortformat:
{
"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.Verbinde BasedOnB mit Claude, Cursor, Windsurf oder jedem MCP-kompatiblen KI-Client. Gleicher API-Schlüssel, gleiche Credits, gleiche v1-Oberfläche — als 10 Tools, die die KI direkt aufrufen kann.
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.
Wähle deinen Client und kopiere das Snippet. Ersetze den Platzhalter-Schlüssel durch deinen eigenen.
claude mcp add basedonb https://www.basedonb.com/api/mcp \
--transport http \
--header "Authorization: Bearer bdb_live_xxxxxxxxxxxxxxxxx"Führe dies in einem beliebigen Terminal aus. MCP wird in allen Claude-Code-Sitzungen verfügbar.
Alle MCP-Tools werden mit demselben bdb_live_…-API-Schlüssel wie die REST-API authentifiziert. Übergib ihn über den Authorization: Bearer-Header auf dem MCP-Transport.
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.