Leads Endpoints

The Leads endpoints help you discover businesses worldwide: • **Google Maps Search** - Find local businesses by query and location (£0.030/request) • **Sources** - List available lead sources (FREE) • **Countries** - Check coverage for any country (FREE) Google Maps results include websites and phone numbers, making them ready for enrichment and outreach.

Search for businesses on Google Maps. **Endpoint:** `POST /v1/leads/search/maps` **Request:** ```json { "query": "web design agencies", "location": "London, UK", "limit": 20 } ``` **Response:** ```json { "success": true, "data": { "businesses": [ { "name": "Digital Agency Ltd", "address": "123 High Street, London", "phone": "+44 20 1234 5678", "website": "digitalagency.co.uk", "rating": 4.8, "reviewCount": 156, "category": "Web Design Agency", "placeId": "ChIJ..." } ], "total": 20, "hasMore": true }, "usage": { "cost": 0.03, "balanceRemaining": 19.97 } } ``` **Cost:** £0.030 per search Results include business name, address, phone, website, ratings, and Google place ID.

Get a list of available lead sources. **Endpoint:** `GET /v1/leads/sources` **Response:** ```json { "success": true, "data": { "sources": [ { "id": "google_maps", "name": "Google Maps", "type": "api", "countries": ["*"], "costPerRequest": 0.03, "globalCoverage": true } ], "total": 1 } } ``` **Cost:** FREE

Check coverage for any country. Google Maps provides global coverage. **Endpoint:** `GET /v1/leads/countries` **Response:** ```json { "success": true, "data": { "globalCoverage": true, "source": "google_maps", "note": "Google Maps covers 200+ countries worldwide" } } ``` **Cost:** FREE