BasedOnBusiness
About
Google Maps business & lead data API and MCP server - search, enrich (email, social, tech stack), and export leads across 195 countries.
Details
- Author
- Unknown
- Categories
- Marketing, Other, API
Jump to
Google Maps lead çekme işlemini REST API ile otomatikleştirin veya MCP sunucusuyla doğrudan AI asistanlarınıza bağlayın.
curl https://www.basedonb.com/api/v1/account \ -H "Authorization: Bearer bdb_live_YOUR_KEY_HERE"
Tüm API istekleri (GET /healthhariç) bir API anahtarı gerektirir.API & Webhooks → API Anahtarlarıüzerinden oluşturun.
Anahtarınızı iki yoldan biriyle gönderin:
REST API'yi güvenilir bir backend üzerinden kullanın. Tarayıcılar arası cross-origin istekler bilinçli olarak kapalıdır; API anahtarlarını istemci tarafı kodunda asla açığa çıkarmayın.
REST yanıtları X-Request-Id içerir. Kimliği doğrulanmış isteklerde ayrıca RateLimit-Limit, RateLimit-Remaining ve RateLimit-Reset; sınıra takılan isteklerde Retry-After gönderilir.
API anahtarı başına dakikada 100 istek. Bu sınırı aşmak429dö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şstatesdizisi döner. Bu işleri yalnızcacountryile gönderin.
Webhook'lar gerçek zamanlı olay bildirimlerini uç noktanıza iletir. Her istek doğrulama için birX-Webhook-Signaturebaşlığı içerir.
API keys are created and revoked only from the authenticated dashboard. Choose the minimum required scopes when creating a key: mcp, scrapes:read, scrapes:write, account:read, geodata:read, webhooks:read, and webhooks:write. Keys cannot create or manage other keys through the public API.
Uç noktanıza iletilen örnekscrape.doneyükü:
POST https://your-server.com/webhook Content-Type: application/json X-Webhook-Id: delivery-uuid X-Webhook-Event-Id: event-uuid X-Webhook-Timestamp: 2026-07-18T10:05:00Z X-Webhook-Signature: v1=abc123... X-Event-Type: scrape.done User-Agent: BasedOnB-Webhook/2.0 { "id": "event-uuid", "event": "scrape.done", "created_at": "2026-01-15T10:05:00Z", "data": { "scrape_id": "job-uuid", "query": "restaurants", "queries": ["restaurants"], "city": "Istanbul", "country": "TR", "state": "TR.34", "state_name": "İstanbul", "status": "done", "leads_found": 47, "credits_charged": 47, "error": null, "results_path": "/api/v1/scrapes/job-uuid/results" } }
İsteklerin BasedOnB'den geldiğinden emin olmak içinX-Webhook-Signaturebaşlığını doğrulayın. Webhook oluşturulurken veya anahtarı yenilenirken yalnızca bir kez gösterilen imzalama anahtarını kaydedin.
import { createHmac, timingSafeEqual } from "node:crypto"; function verifyWebhook(body: string, timestamp: string, signature: string, secret: string): boolean { const match = /^v1=([0-9a-f]{64})$/i.exec(signature); if (!match) return false; const expected = createHmac("sha256", secret) .update(timestamp + "." + body) .digest(); const received = Buffer.from(match[1], "hex"); return received.length === expected.length && timingSafeEqual(received, expected); } // In your endpoint handler: const body = await req.text(); const sig = req.headers.get("X-Webhook-Signature") ?? ""; const timestamp = req.headers.get("X-Webhook-Timestamp") ?? ""; if (!verifyWebhook(body, timestamp, sig, process.env.WEBHOOK_SECRET!)) { return new Response("Unauthorized", { status: 401 }); }
Teslimatı onaylamak için herhangi bir 2xx durum kodu döndürün. Başarısız teslimatlar 1 dakika, 5 dakika, 30 dakika ve 2 saat sonra, en fazla 5 denemeye kadar tekrarlanır. X-Webhook-Event-Id değerini saklayıp daha önce işlenen olayları yok sayın. Timestamp olayın oluşturulma zamanıdır ve retry'larda değişmez; geçerli bir retry'ı yalnızca timestamp eski diye reddetmeyin.
{ "error": { "code": "insufficient_credits", "message": "Not enough credits. You have 3 but need 50." } }
Ayarlar'dan ilk API anahtarınızı oluşturun ve dakikalar içinde taramaya başlayın.
Free MCP that drives an audit of your marketing. Your AI connects, adsOS digs through your ads, email and site, and hands back a growth plan you can run today.
Access real-time exclusive B2B data APIs that power your AI agents and workflows
MCP server for Apollo.io, search leads, enrich contacts, manage sequences & CRM from Claude Code, Cursor, or any MCP client. 45+ tool calls covering the full Apollo.io API.
Resolve any combination of company name, domain, or LinkedIn URL into one canonical company identity with confidence scores.
MCP server for B2B data enrichment via Derrick: find verified emails, phone numbers, and 100+ LinkedIn/company data points natively from agents. Powered by Google Sheets-native Derrick API.
Free -> no API key required. Domain/companyname -> company intelligence for AI agents. Look up company name, country, contacts, and social profiles from any MCP-compatible client.
Rolls hiring and tech-stack signals into a single go-to-market fit score for fast account prioritization. Part of the Mamba Labs signal toolkit.
Qualifies accounts against your ideal customer profile and returns a score, tier, and per-signal reasoning. Part of the Mamba Labs signal toolkit.
Six go-to-market signal tools in a single MCP server, from hiring detection to ICP scoring, all returning flat Clay-ready data.
B2B lead generation, email verification, company enrichment, and governed GTM Ops.
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.




