Google Maps lead çekme işlemini REST API ile otomatikleştirin veya MCP sunucusuyla doğrudan AI asistanlarınıza bağlayın.
Ayarlar'dan ilk API anahtarınızı oluşturun ve dakikalar içinde taramaya başlayın.
curl https://www.basedonb.com/api/v1/account \
-H "Authorization: Bearer bdb_live_YOUR_KEY_HERE"Tüm API istekleri (GET /health hariç) bir API anahtarı gerektirir. Ayarlar → API Anahtarları üzerinden oluşturun.
Anahtarınızı iki yoldan biriyle gönderin:
Authorization header (önerilen)
Authorization: Bearer bdb_live_...
X-API-Key header
X-API-Key: bdb_live_...
https://www.basedonb.com/api/v1
API anahtarı başına dakikada 100 istek. Bu sınırı aşmak 429 döner.
Scrapes API'nin kabul ettiği ülke / eyalet / şehir değerlerini arayın. Eyaletler GeoNames nokta kod formatını izler (US.CA, TR.34, DE.BE). Alt bölüm içermeyen ülkeler boş states dizisi döner — bu işleri yalnızca country ile gönderin.
Webhook'lar gerçek zamanlı olay bildirimlerini uç noktanıza iletir. Her istek doğrulama için bir X-Webhook-Signature başlığı içerir.
Uç noktanıza iletilen örnek scrape.done yükü:
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
}
}İsteklerin BasedOnB'den geldiğinden emin olmak için X-Webhook-Signature başlığını doğrulayın. Webhook gizli anahtarınızı Ayarlar → Webhook'lar bölümünde bulun.
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 Durum | Kod | Açıklama |
|---|---|---|
| 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 |
Hata yanıt formatı:
{
"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.BasedOnB'yi Claude, Cursor, Windsurf veya MCP destekli her AI istemcisine bağla. Aynı API anahtarı, aynı kredi, aynı v1 yüzeyi — AI'ın doğrudan çağırabileceği 10 araç olarak.
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.
İstemcini seç, snippet'i kopyala. Yer tutucu anahtarı kendi anahtarınla değiştir.
claude mcp add basedonb https://www.basedonb.com/api/mcp \
--transport http \
--header "Authorization: Bearer bdb_live_xxxxxxxxxxxxxxxxx"Bu komutu herhangi bir terminalde çalıştır. MCP, tüm Claude Code oturumlarında kullanılabilir olur.
Tüm MCP araçları REST API ile aynı bdb_live_… anahtarıyla yetkilendirilir. MCP transport üzerinden Authorization: Bearer header'ı ile gönder.
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.