# Generador de Leads B2B con Email Verificado y Teléfono (`lentic_euphonium/lead-generator`) Actor Extrae listas de empresas locales (leads B2B) por sector y ciudad, con email verificado, teléfono, web y dirección. Datos limpios, deduplicados y de fuente abierta (OpenStreetMap). 30 sectores. - **URL**: https://apify.com/lentic\_euphonium/lead-generator.md - **Developed by:** [toni lopera](https://apify.com/lentic_euphonium) (community) - **Categories:** Lead generation - **Stats:** 2 total users, 1 monthly users, 33.3% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $5.00 / 1,000 results This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ### Leads B2B verificados de empresas locales (email + teléfono, RGPD) **Genera listas de empresas locales para prospección B2B con contactos verificados**, por sector y ciudad. Cada email se comprueba contra DNS (registros MX) para confirmar que el dominio **acepta correo** → menos rebotes. Los teléfonos salen normalizados (formato internacional, móvil/fijo). Todo limpio, sin duplicados y a partir de **datos abiertos y legales de [OpenStreetMap](https://www.openstreetmap.org/)** — ideal para cumplimiento **RGPD**, sin el riesgo de las bases compradas de origen dudoso. Descarga en **JSON, CSV o Excel**, o consume por API. ### ¿Por qué este generador de leads? En datos B2B, lo que de verdad importa no es el volumen, es la **deliverabilidad**: una lista con emails muertos te quema el dominio y arruina la campaña. Este Actor ataca justo eso: - ✅ **Email verificado (MX/DNS)** → marca cada email como dominio que acepta correo. Pide *Solo email verificado* y obtén únicamente el trozo entregable. - ✅ **Teléfonos normalizados** (E.164) con tipo móvil/fijo → perfecto para llamada o WhatsApp en negocios locales. - ✅ **Datos de fuente abierta y legal** (OpenStreetMap) → defendible bajo RGPD, frente a listas opacas. - ✅ **Frescura**: cada lead lleva su fecha de extracción (`extracted_at`). - ✅ **Sin duplicados** y con dirección estructurada. > Una ciudad como Barcelona devuelve **miles de empresas con teléfono normalizado** y **más de mil con email verificado** — contactos listos para usar, no un volumen inflado de direcciones muertas. ### Cómo extraer leads verificados 1. Elige el **sector** (30 disponibles). 2. Escribe **ciudad** + **código de país** (ej: Barcelona, ES). 3. Activa **Solo email verificado** si quieres únicamente el trozo entregable, o los filtros de teléfono/web. 4. Pulsa **Start** y descarga en CSV, Excel o JSON. ### Sectores disponibles Salud (dentistas, médicos, farmacias, fisioterapeutas, veterinarios, ópticas), servicios profesionales (abogados, asesorías, seguros, arquitectos, inmobiliarias, agencias de viajes), belleza y bienestar (gimnasios, spas, peluquerías, estética), hostelería (restaurantes, cafeterías, bares, comida rápida, hoteles), comercio (panaderías, carnicerías, floristerías, ropa, joyerías, supermercados), automoción, autoescuelas y guarderías. ### Input | Campo | Descripción | |-------|-------------| | `sector` | Tipo de negocio (30 sectores). | | `city` | Ciudad o municipio. | | `countryCode` | Código ISO de país (acota la búsqueda y normaliza teléfonos). | | `maxResults` | Máximo de leads (0 = sin límite). | | `requireVerifiedEmail` | Devuelve solo leads con email verificado (deliverable). | | `requirePhone` / `requireWebsite` | Filtra por teléfono o web. | | `enrichEmails` | Visita las webs para recuperar emails que no están en los datos abiertos. | ### Output ```json { "name": "Clínica Garzón Dental", "phone": "+34933000000", "phone_type": "fijo", "email": "info@garzondental.com", "email_verified": true, "website": "https://garzondental.com/", "address": "Carrer de Provença 490", "postcode": "08025", "city": "Barcelona", "extracted_at": "2026-06-28", "data_quality": 1.0 } ```` Descarga el dataset en **JSON, CSV, Excel o HTML**. ### Campos de datos | Campo | Significado | |-------|-------------| | `name` | Nombre del negocio. | | `phone` / `phone_type` | Teléfono internacional (E.164) y tipo (móvil/fijo). | | `email` / `email_verified` | Email y si su dominio acepta correo (MX). | | `email_source` | Origen del email: `osm` o `website`. | | `website` | Web del negocio. | | `address` / `postcode` / `city` | Dirección, código postal y municipio. | | `extracted_at` | Fecha de extracción (frescura del dato). | | `data_quality` | Puntuación 0–1 según campos de contacto presentes. | ### El diferencial: calidad, no volumen - **Verificación de email por DNS (MX)** → contactos entregables, no listas con 20-40% de rebote. - **Enriquecimiento web**: visita home, contacto, aviso legal y privacidad para recuperar emails. - **Normalización de teléfonos** (E.164) y clasificación móvil/fijo. - **Acotado al polígono real del municipio**, no a un rectángulo aproximado. - **Deduplicación** por nombre + dirección. ### Cumplimiento y aviso legal Los datos provienen de OpenStreetMap (fuente abierta y pública), lo que facilita una base **defendible bajo RGPD** frente a listas de origen opaco. El uso de los leads para comunicaciones comerciales es responsabilidad de quien los utiliza y debe respetar la normativa aplicable (RGPD, LSSI), incluyendo el interés legítimo y el derecho de oposición. ### Soporte ¿Sugerencias o errores? Usa la pestaña **Issues** del Actor. # Actor input Schema ## `sector` (type: `string`): Tipo de negocio del que generar leads. ## `city` (type: `string`): Ciudad o municipio donde buscar (ej: Barcelona, Madrid, Valencia). ## `countryCode` (type: `string`): Código ISO de 2 letras. Se usa para acotar la búsqueda y normalizar los teléfonos. ## `maxResults` (type: `integer`): Número máximo de leads a devolver (0 = sin límite). ## `requirePhone` (type: `boolean`): Descarta los leads que no tengan un teléfono válido. ## `requireWebsite` (type: `boolean`): Descarta los leads que no tengan página web. ## `requireVerifiedEmail` (type: `boolean`): Devuelve únicamente leads con un email cuyo dominio está verificado (acepta correo, MX). El trozo premium: máxima deliverabilidad. ## `enrichEmails` (type: `boolean`): Visita la web de los negocios sin email para intentar recuperarlo. Mejora mucho la cobertura de email, pero hace la ejecución más lenta. ## Actor input object example ```json { "sector": "dentist", "city": "Barcelona", "countryCode": "ES", "maxResults": 200, "requirePhone": false, "requireWebsite": false, "requireVerifiedEmail": false, "enrichEmails": true } ``` # Actor output Schema ## `results` (type: `string`): No description # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "city": "Barcelona", "countryCode": "ES" }; // Run the Actor and wait for it to finish const run = await client.actor("lentic_euphonium/lead-generator").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "city": "Barcelona", "countryCode": "ES", } # Run the Actor and wait for it to finish run = client.actor("lentic_euphonium/lead-generator").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "city": "Barcelona", "countryCode": "ES" }' | apify call lentic_euphonium/lead-generator --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=lentic_euphonium/lead-generator", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Generador de Leads B2B con Email Verificado y Teléfono", "description": "Extrae listas de empresas locales (leads B2B) por sector y ciudad, con email verificado, teléfono, web y dirección. Datos limpios, deduplicados y de fuente abierta (OpenStreetMap). 30 sectores.", "version": "0.3", "x-build-id": "u1KKAbbuX1FHWHQQJ" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/lentic_euphonium~lead-generator/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-lentic_euphonium-lead-generator", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/lentic_euphonium~lead-generator/runs": { "post": { "operationId": "runs-sync-lentic_euphonium-lead-generator", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/lentic_euphonium~lead-generator/run-sync": { "post": { "operationId": "run-sync-lentic_euphonium-lead-generator", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "required": [ "sector", "city" ], "properties": { "sector": { "title": "Sector", "enum": [ "dentist", "doctors", "pharmacy", "physiotherapist", "veterinary", "optician", "lawyer", "accountant", "insurance", "architect", "real_estate", "travel_agency", "gym", "spa", "hairdresser", "beauty", "restaurant", "cafe", "bar", "fast_food", "hotel", "bakery", "butcher", "florist", "clothes", "jewelry", "supermarket", "car_repair", "driving_school", "kindergarten" ], "type": "string", "description": "Tipo de negocio del que generar leads.", "default": "dentist" }, "city": { "title": "Ciudad", "type": "string", "description": "Ciudad o municipio donde buscar (ej: Barcelona, Madrid, Valencia)." }, "countryCode": { "title": "Código de país", "type": "string", "description": "Código ISO de 2 letras. Se usa para acotar la búsqueda y normalizar los teléfonos.", "default": "ES" }, "maxResults": { "title": "Máximo de leads", "minimum": 0, "type": "integer", "description": "Número máximo de leads a devolver (0 = sin límite).", "default": 200 }, "requirePhone": { "title": "Solo con teléfono", "type": "boolean", "description": "Descarta los leads que no tengan un teléfono válido.", "default": false }, "requireWebsite": { "title": "Solo con web", "type": "boolean", "description": "Descarta los leads que no tengan página web.", "default": false }, "requireVerifiedEmail": { "title": "Solo email verificado", "type": "boolean", "description": "Devuelve únicamente leads con un email cuyo dominio está verificado (acepta correo, MX). El trozo premium: máxima deliverabilidad.", "default": false }, "enrichEmails": { "title": "Enriquecer emails", "type": "boolean", "description": "Visita la web de los negocios sin email para intentar recuperarlo. Mejora mucho la cobertura de email, pero hace la ejecución más lenta.", "default": true } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```