# Italian Hospitality Lead Qualifier (`viable_guard/italian-hospitality-lead-qualifier`) Actor Find Italian hotels, B\&Bs and restaurants with public commercial opportunity signals: weak/broken website, missing booking CTA, missing WhatsApp/socials, public contacts, and outreach-ready sales angles. - **URL**: https://apify.com/viable\_guard/italian-hospitality-lead-qualifier.md - **Developed by:** [Matteo](https://apify.com/viable_guard) (community) - **Categories:** Lead generation, Travel, SEO tools - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $15.00 / 1,000 qualified italian hospitality leads This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. 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 ## Italian Hospitality Lead Qualifier Find Italian hotels, B&Bs, guest houses, and restaurants with public commercial opportunity signals: broken or weak websites, missing booking CTAs, missing WhatsApp/social links, public contacts, and outreach-ready sales angles. This Actor is designed for web agencies, hospitality marketing consultants, local SEO providers, booking engine vendors, and CRM/lead-generation teams that need more than a raw list of businesses. ### What it does Given one or more Italian locations, or a direct `inputBusinesses` list, the Actor: 1. accepts known business websites from a CRM, Google Maps export, spreadsheet, or manual list; 2. optionally discovers public hospitality businesses from OpenStreetMap/Overpass; 3. filters businesses with a public website; 4. audits the website homepage and likely contact/about/booking pages; 5. extracts public emails, phones, and social links when visible; 6. detects commercial opportunity signals; 7. returns a qualified lead with an `opportunityScore` and concrete `salesAngles`. The `inputBusinesses` mode is recommended when you already have target accounts and want scoring/enrichment rather than public discovery. It also avoids depending on public Overpass availability. ### Use cases - Build prospect lists for hospitality web design outreach. - Find hotels/B&Bs with broken or outdated websites. - Find restaurants without WhatsApp/social/booking CTAs. - Enrich local business CRM records with public website weakness signals. - Prioritize outreach by concrete sales angle instead of generic scraping. ### Input example #### Discover by location ```json { "locations": ["Rimini", "Sorrento", "Desenzano del Garda"], "businessTypes": ["hotel", "guest_house", "restaurant"], "maxPlacesPerLocation": 100, "maxBusinessesToAudit": 50, "minOpportunityScore": 35, "includeContactExtraction": true, "includeWebsiteAudit": true, "language": "it" } ```` #### Audit your own business list ```json { "inputBusinesses": [ { "businessName": "Hotel Nice", "category": "hotel", "location": "Sorrento", "website": "http://www.hotelnicesorrento.com/" } ], "locations": [], "maxBusinessesToAudit": 50, "minOpportunityScore": 35 } ``` ### Output fields Each dataset item includes: - `businessName` - `category` - `location` - `address` - `phone` - `website` - `normalizedWebsite` - `publicEmails` - `publicPhones` - `socialLinks` - `statusCode` - `checkedPages` - `signals` - `technologies` - `opportunityScore` - `salesAngles` - `source` - `sourceId` - `checkedAt` - `error` ### Example output table The Actor writes one dataset item per qualified lead. This is the kind of table buyers can export to CSV/JSON and use for outreach prioritization. | Business | Location | Score | Website issue | Public contacts | Sales angle | |---|---:|---:|---|---|---| | Hotel Nice | Sorrento | 42 | HTTP site, no WhatsApp detected | 2 public phones | Improve trust and mobile conversion with HTTPS + WhatsApp CTA. | | B\&B Belvedere Sorrento | Sorrento | 38 | Site timeout during check | none detected | Verify unreachable site and rebuild the direct booking path. | | Bed and Breakfast Ca' Rossa | Rimini | 63 | DNS failure on listed website | 1 public phone | Fix broken domain and recover public booking presence. | | Example Hotel | Rimini | 72 | Missing booking CTA + weak meta description | email + phone + social | Sell direct-booking, WhatsApp, and local SEO improvements. | ### Example JSON item ```json { "businessName": "Example Hotel", "category": "hotel", "location": "Rimini", "website": "https://examplehotel.it", "normalizedWebsite": "https://examplehotel.it/", "publicEmails": ["info@examplehotel.it"], "publicPhones": ["+39 0541 000000"], "socialLinks": ["https://www.instagram.com/examplehotel"], "statusCode": 200, "signals": { "hasHttps": true, "httpStatusOk": true, "fetchIssueType": "ok", "hasPublicEmail": true, "hasPublicPhone": true, "hasWhatsapp": false, "hasBookingEngineOrBookingCTA": false, "missingMetaDescription": true }, "opportunityScore": 72, "salesAngles": [ "Booking engine/CTA prenotazione non rilevata: opportunità per prenotazioni dirette.", "WhatsApp non rilevato: opportunità per contatto rapido da mobile.", "Meta description mancante/debole: opportunità SEO/local search." ], "checkedAt": "2026-07-04T20:05:10.758264+00:00" } ``` ### Pricing This Actor is monetized with Apify Pay Per Event: - `$0.015` per qualified Italian hospitality lead written to the dataset; - displayed in the Store as **from $15.00 / 1,000 qualified Italian hospitality leads**; - buyers pay for actionable output rows, not for raw places discovered. ### Data sources and compliance The prototype uses public OpenStreetMap/Overpass business records and public business websites. It does not log into websites and does not use private data. Email/phone extraction is limited to publicly visible business contact data. Users are responsible for complying with applicable outreach, privacy, and anti-spam laws. ### Current limitations - OpenStreetMap data can be stale; stale/broken websites are useful signals but should be interpreted carefully. - Some websites block automated requests with HTTP 403; these are classified separately from broken websites. - DNS failures, 404s, 403/blocked pages, timeouts, and SSL errors are separated in `signals.fetchIssueType`. - Booking engine detection is keyword-based in the first version. - Phone and social extraction uses conservative filters, but buyer review is still recommended before outreach. # Actor input Schema ## `inputBusinesses` (type: `array`): Optional list of known businesses to audit directly. Use this to bring your own Google Maps export, CRM rows, or manually selected websites. If provided together with locations, both sources are combined and deduplicated. ## `locations` (type: `array`): Italian city or area names to search in OpenStreetMap/Overpass. Leave empty if using inputBusinesses only. ## `businessTypes` (type: `array`): Hospitality categories to include. Supported values are hotel, guest\_house, and restaurant. ## `maxPlacesPerLocation` (type: `integer`): Maximum OSM records requested per location before website filtering. ## `maxBusinessesToAudit` (type: `integer`): Maximum websites to crawl in one run. ## `minOpportunityScore` (type: `integer`): Only leads with score greater than or equal to this value are pushed to the dataset. ## `includeContactExtraction` (type: `boolean`): When enabled, extract public emails, phone numbers, WhatsApp links, and social links from the audited websites. ## `includeWebsiteAudit` (type: `boolean`): When enabled, detect weak website and conversion signals such as broken sites, missing HTTPS, missing booking CTAs, and weak metadata. ## `language` (type: `string`): Language for sales angle labels. ## `overpassEndpoints` (type: `array`): Advanced: fallback Overpass API endpoints for public OpenStreetMap discovery. Leave default unless one endpoint is unreliable. ## Actor input object example ```json { "inputBusinesses": [ { "businessName": "Hotel Nice", "category": "hotel", "location": "Sorrento", "website": "http://www.hotelnicesorrento.com/" } ], "locations": [ "Rimini", "Sorrento", "Desenzano del Garda" ], "businessTypes": [ "hotel", "guest_house", "restaurant" ], "maxPlacesPerLocation": 100, "maxBusinessesToAudit": 50, "minOpportunityScore": 35, "includeContactExtraction": true, "includeWebsiteAudit": true, "language": "it", "overpassEndpoints": [ "https://overpass-api.de/api/interpreter", "https://overpass.kumi.systems/api/interpreter" ] } ``` # 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 = { "inputBusinesses": [ { "businessName": "Hotel Nice", "category": "hotel", "location": "Sorrento", "website": "http://www.hotelnicesorrento.com/" } ], "locations": [ "Rimini", "Sorrento", "Desenzano del Garda" ], "businessTypes": [ "hotel", "guest_house", "restaurant" ], "overpassEndpoints": [ "https://overpass-api.de/api/interpreter", "https://overpass.kumi.systems/api/interpreter" ] }; // Run the Actor and wait for it to finish const run = await client.actor("viable_guard/italian-hospitality-lead-qualifier").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 = { "inputBusinesses": [{ "businessName": "Hotel Nice", "category": "hotel", "location": "Sorrento", "website": "http://www.hotelnicesorrento.com/", }], "locations": [ "Rimini", "Sorrento", "Desenzano del Garda", ], "businessTypes": [ "hotel", "guest_house", "restaurant", ], "overpassEndpoints": [ "https://overpass-api.de/api/interpreter", "https://overpass.kumi.systems/api/interpreter", ], } # Run the Actor and wait for it to finish run = client.actor("viable_guard/italian-hospitality-lead-qualifier").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 '{ "inputBusinesses": [ { "businessName": "Hotel Nice", "category": "hotel", "location": "Sorrento", "website": "http://www.hotelnicesorrento.com/" } ], "locations": [ "Rimini", "Sorrento", "Desenzano del Garda" ], "businessTypes": [ "hotel", "guest_house", "restaurant" ], "overpassEndpoints": [ "https://overpass-api.de/api/interpreter", "https://overpass.kumi.systems/api/interpreter" ] }' | apify call viable_guard/italian-hospitality-lead-qualifier --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=viable_guard/italian-hospitality-lead-qualifier", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Italian Hospitality Lead Qualifier", "description": "Find Italian hotels, B&Bs and restaurants with public commercial opportunity signals: weak/broken website, missing booking CTA, missing WhatsApp/socials, public contacts, and outreach-ready sales angles.", "version": "0.2", "x-build-id": "u285xMk3U9wozHGhO" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/viable_guard~italian-hospitality-lead-qualifier/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-viable_guard-italian-hospitality-lead-qualifier", "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/viable_guard~italian-hospitality-lead-qualifier/runs": { "post": { "operationId": "runs-sync-viable_guard-italian-hospitality-lead-qualifier", "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/viable_guard~italian-hospitality-lead-qualifier/run-sync": { "post": { "operationId": "run-sync-viable_guard-italian-hospitality-lead-qualifier", "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", "properties": { "inputBusinesses": { "title": "Input businesses", "type": "array", "description": "Optional list of known businesses to audit directly. Use this to bring your own Google Maps export, CRM rows, or manually selected websites. If provided together with locations, both sources are combined and deduplicated.", "items": { "type": "object", "required": [ "businessName", "website" ], "properties": { "businessName": { "type": "string", "title": "Business name", "description": "Business name to show in the output dataset." }, "name": { "type": "string", "title": "Alternative business name", "description": "Alternative alias for businessName, useful when importing generic CSV/JSON rows." }, "category": { "type": "string", "title": "Category", "description": "Hospitality category such as hotel, guest_house, bed_and_breakfast, or restaurant." }, "location": { "type": "string", "title": "Location", "description": "City or area associated with the business." }, "website": { "type": "string", "title": "Website", "description": "Public website URL to audit. Bare domains are accepted and normalized to HTTPS." }, "address": { "type": "string", "title": "Address", "description": "Optional public address for context and CRM export." }, "phone": { "type": "string", "title": "Phone", "description": "Optional public phone from the source list; it is cleaned and merged into publicPhones." }, "lat": { "type": "number", "title": "Latitude", "description": "Optional latitude from the source list." }, "lon": { "type": "number", "title": "Longitude", "description": "Optional longitude from the source list." } } } }, "locations": { "title": "Locations", "type": "array", "description": "Italian city or area names to search in OpenStreetMap/Overpass. Leave empty if using inputBusinesses only.", "items": { "type": "string" }, "default": [ "Rimini" ] }, "businessTypes": { "title": "Business types", "type": "array", "description": "Hospitality categories to include. Supported values are hotel, guest_house, and restaurant.", "items": { "type": "string" }, "default": [ "hotel", "guest_house", "restaurant" ] }, "maxPlacesPerLocation": { "title": "Max places per location", "minimum": 1, "maximum": 500, "type": "integer", "description": "Maximum OSM records requested per location before website filtering.", "default": 100 }, "maxBusinessesToAudit": { "title": "Max businesses to audit", "minimum": 1, "maximum": 300, "type": "integer", "description": "Maximum websites to crawl in one run.", "default": 50 }, "minOpportunityScore": { "title": "Minimum opportunity score", "minimum": 0, "maximum": 100, "type": "integer", "description": "Only leads with score greater than or equal to this value are pushed to the dataset.", "default": 35 }, "includeContactExtraction": { "title": "Extract public contacts", "type": "boolean", "description": "When enabled, extract public emails, phone numbers, WhatsApp links, and social links from the audited websites.", "default": true }, "includeWebsiteAudit": { "title": "Run website opportunity audit", "type": "boolean", "description": "When enabled, detect weak website and conversion signals such as broken sites, missing HTTPS, missing booking CTAs, and weak metadata.", "default": true }, "language": { "title": "Output language", "enum": [ "it", "en" ], "type": "string", "description": "Language for sales angle labels.", "default": "it" }, "overpassEndpoints": { "title": "Overpass endpoints", "type": "array", "description": "Advanced: fallback Overpass API endpoints for public OpenStreetMap discovery. Leave default unless one endpoint is unreliable.", "items": { "type": "string" }, "default": [ "https://overpass-api.de/api/interpreter", "https://overpass.kumi.systems/api/interpreter" ] } } }, "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 } } } } } } } } } } ```