Endpoint leads

Gli endpoint lead ti aiutano a scoprire aziende in tutto il mondo: • **Google Maps Search** - trova aziende locali per query e località (€0,035/richiesta) • **Sources** - elenca le fonti di lead disponibili (GRATIS) • **Countries** - verifica la copertura per ogni paese (GRATIS) I risultati di Google Maps includono sito web e numero di telefono, pronti per arricchimento e attività di outreach.

Cerca aziende su Google Maps. **Endpoint:** `POST /v1/leads/search/maps` **Richiesta:** ```json { "query": "agenzie web design", "location": "Milano, Italia", "limit": 20 } ``` **Risposta:** ```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 } } ``` **Costo:** €0,035 per ricerca I risultati includono nome dell'azienda, indirizzo, telefono, sito web, valutazioni e Google Place ID.

Ottieni l'elenco delle fonti di lead disponibili. **Endpoint:** `GET /v1/leads/sources` **Risposta:** ```json { "success": true, "data": { "sources": [ { "id": "google_maps", "name": "Google Maps", "type": "api", "countries": ["*"], "costPerRequest": 0.03, "globalCoverage": true } ], "total": 1 } } ``` **Costo:** GRATIS

Verifica la copertura per ogni paese. Google Maps offre copertura globale. **Endpoint:** `GET /v1/leads/countries` **Risposta:** ```json { "success": true, "data": { "globalCoverage": true, "source": "google_maps", "note": "Google Maps covers 200+ countries worldwide" } } ``` **Costo:** GRATIS