Automatisez le scraping de prospects Google Maps via l'API REST, ou connectez directement vos assistants IA grâce au serveur MCP.
Générez votre première clé API dans Paramètres et commencez à scraper en quelques minutes.
curl https://www.basedonb.com/api/v1/account \
-H "Authorization: Bearer bdb_live_YOUR_KEY_HERE"Toutes les requêtes API (sauf GET /health) nécessitent une clé API. Générez-en une depuis Settings → API Keys.
Transmettez votre clé de l'une des deux façons :
En-tête Authorization (recommandé)
Authorization: Bearer bdb_live_...
En-tête X-API-Key
X-API-Key: bdb_live_...
https://www.basedonb.com/api/v1
100 requêtes / minute par clé API. Un dépassement renvoie 429.
Recherchez les valeurs pays / état / ville acceptées par l'API Scrapes. Les états suivent le format de code en points GeoNames (US.CA, TR.34, DE.BE). Les pays sans subdivision renvoient un tableau states vide — soumettez ces tâches avec uniquement country.
Les webhooks livrent des notifications d'événements en temps réel à votre endpoint. Chaque requête inclut un en-tête X-Webhook-Signature pour la vérification.
Exemple de charge utile scrape.done livrée à votre 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
}
}Vérifiez l'en-tête X-Webhook-Signature pour vous assurer que les requêtes proviennent de BasedOnB. Trouvez votre secret webhook dans Paramètres → 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 });
}| Statut HTTP | Code | Description |
|---|---|---|
| 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 |
Format de réponse d'erreur :
{
"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.Connecte BasedOnB à Claude, Cursor, Windsurf ou tout client IA compatible MCP. Même clé API, mêmes crédits, même surface v1 — exposés sous forme de 10 outils que l'IA peut appeler directement.
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.
Choisis ton client et copie le snippet. Remplace la clé d'exemple par la tienne.
claude mcp add basedonb https://www.basedonb.com/api/mcp \
--transport http \
--header "Authorization: Bearer bdb_live_xxxxxxxxxxxxxxxxx"Exécute ceci dans n'importe quel terminal. MCP devient disponible dans toutes les sessions Claude Code.
Tous les outils MCP s'authentifient avec la même clé bdb_live_… que l'API REST. Transmets-la via l'en-tête Authorization: Bearer sur le transport 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.