# SmartHotels Sales Opportunity Scanner (`axmaxcoding/smarthotels-sales-opportunity-scanner`) Actor
Turn hotel prospect lists into evidence-safe B2B sales intelligence with score, fit, room-count evidence, source-backed signals, outreach guidance, and CSV export.
- **URL**: https://apify.com/axmaxcoding/smarthotels-sales-opportunity-scanner.md
- **Developed by:** [Axel Maldonado](https://apify.com/axmaxcoding) (community)
- **Categories:** Travel, Lead generation, Automation
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 1 bookmarks
- **User rating**: No ratings yet
## Pricing
from $3.00 / hotel basic audit
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
## ๐จ SmartHotels Sales Opportunity Scanner
**Turn hotel prospect lists into evidence-safe B2B sales intelligence.**
SmartHotels helps hospitality vendors, agencies, and sales teams decide which hotel accounts deserve outreach first, what angle to use, and which claims are actually supported by evidence.
โ
Rank hotel prospects by sales opportunity
โ
Estimate room scale with evidence status
โ
Detect digital guest-experience and commercial fit signals
โ
Generate safe outreach angles and next best actions
โ
Export JSON/CSV-ready results for sales workflows
โ
Keep unknown facts visible instead of inventing them
### ๐ What does this Actor do?
SmartHotels Sales Opportunity Scanner analyzes one hotel or a batch of hotels and returns a structured sales-intelligence report.
Instead of giving you raw scraped data, it helps answer:
- **Which hotels are worth contacting first?**
- **Does the hotel have enough scale for your offer?**
- **What sales angle fits this account?**
- **What evidence supports the recommendation?**
- **What should your first message say?**
This is not a generic hotel scraper. It is a prospect qualification tool for B2B hotel sales workflows.
### ๐ฏ Best use cases
#### ๐จ Single hotel audit
Evaluate one hotel before outreach. Get fit, score, evidence status, recommended sales angle, and next best action.
#### ๐ Batch lead enrichment
Upload up to 10 or 100 hotels and receive ranked JSON/CSV-ready records for spreadsheet, CRM review, or outbound workflows.
#### ๐ Regional prospecting
Prepare a city, country, or segment-focused hotel campaign with a first pass of account quality and outreach priority.
#### โ๏ธ Evidence-safe outreach prep
Draft a first-touch message without inventing vendor usage, personal contacts, emails, or unsupported hotel facts.
### ๐ฅ Who is it for?
SmartHotels is built for teams that sell into hotels, including:
- hospitality software vendors;
- guest-experience technology providers;
- digital reading, media, or guest-content vendors;
- sustainability solution providers;
- marketing and lead-generation agencies;
- B2B sales teams targeting hotel accounts;
- founders building hotel prospecting campaigns.
The hotel is the analyzed account. The buyer is the company trying to sell to that hotel.
### ๐ฆ What data do you get?
| Field | Meaning |
|---|---|
| `opportunityScore` | How strong the account looks for B2B outreach |
| `commercialFit` | High / Medium / Low fit for the buyer's offer |
| `estimatedRooms` | Room scale when evidence-safe |
| `officialWebsiteFetched` | Whether the official site was fetched |
| `pressReaderIntelligence` | Digital reading / vendor status intelligence with safe labels |
| `salesAngle` | Suggested commercial angle |
| `nextBestAction` | What to do next |
| `firstEmailMessage` | Safe first-touch draft |
| `sources` | Source references and evidence notes |
| `evidenceClaims` | Which output claims are supported |
### ๐งช Example input
Single-hotel input:
```json
{
"hotelName": "Six Senses Rome",
"city": "Rome",
"country": "Italy",
"hotelWebsite": "https://www.sixsenses.com/en/hotels/rome",
"serviceToSell": "digital newspapers and magazines for hotel guests",
"includeCSV": true
}
````
Batch input:
```json
{
"hotels": [
{
"hotelName": "Six Senses Rome",
"city": "Rome",
"country": "Italy",
"hotelWebsite": "https://www.sixsenses.com/en/hotels/rome",
"serviceToSell": "digital newspapers and magazines for hotel guests"
},
{
"hotelName": "Hotel de Russie",
"city": "Rome",
"country": "Italy",
"hotelWebsite": "https://www.roccofortehotels.com/hotels-and-resorts/hotel-de-russie/",
"serviceToSell": "guest experience software"
}
],
"includeCSV": true
}
```
Recommended buyer inputs:
- hotel name;
- city;
- country;
- official website when available;
- service or product category being sold;
- `includeCSV` for batch exports.
### ๐ Example output
| Hotel | City | Rooms | Fit | Score | Website fetch | Sales action |
|---|---|---:|---|---:|---|---|
| Six Senses Rome | Rome | 96 | High | 80 | Fetched | Contact guest experience or operations with a premium digital-service angle. |
| Hotel de Russie | Rome | 120 | High | 85 | Fetched | Prioritize for premium guest-experience outreach. |
| Park Hyatt Milan | Milan | 106 | Medium | 77 | Rate-limited official fetch | Keep official-fetch status separate from room-count resolution; use cross-source room evidence. |
Example JSON fields:
```json
{
"hotelName": "Six Senses Rome",
"city": "Rome",
"country": "Italy",
"officialWebsiteFetched": true,
"estimatedRooms": 96,
"commercialFit": "High",
"opportunityScore": 80,
"confidenceLevel": "Medium",
"targetContactRole": "Guest experience, operations, or rooms division",
"nextBestAction": "Send a short discovery message and ask who owns digital guest experience.",
"evidenceClaims": [
{
"field": "estimatedRooms",
"status": "confirmed",
"source": "verified public source"
}
]
}
```
CSV output is written to the key-value store as:
```text
hotel-sales-opportunities.csv
```
Batch summary is written as:
```text
batch-summary.json
```
### ๐ณ Pricing
| Event | What it means | Price |
|---|---|---:|
| `hotel_basic_audit` | 1 hotel opportunity report | USD 3 |
| `hotel_batch_10` | Up to 10 hotel reports | USD 19 |
| `hotel_batch_100` | Up to 100 hotel reports | USD 99 |
Deferred events are not part of the launch MVP:
- `hotel_advanced_report`
- `csv_enrichment`
- `market_prospecting_report`
### ๐ก๏ธ Evidence-safe by design
SmartHotels is designed to keep unknown facts unknown.
It does **not** invent:
- personal emails;
- guessed email patterns;
- manager names;
- phone numbers;
- room counts without evidence;
- current vendor usage unless evidence marks it as verified;
- Google Maps or nearby-hotel claims.
If something is unknown, blocked, or not confirmed, the output says so.
Park Hyatt Milan example:
- official Hyatt pages returned HTTP 429 during validation;
- that is an official-fetch status, not missing hotel data;
- room count is resolved through cross-source evidence;
- official website fetch status stays separate from resolved facts.
### โ ๏ธ Limitations
- Some hotel websites block automated fetches or return rate limits.
- Official website fetch status is not the same as total data resolution.
- Personal contact discovery is not part of the MVP.
- General hotel email enrichment is a future source-backed feature; this Actor does not guess email patterns.
- Google Maps or nearby-hotel discovery is not part of the MVP.
- Live PressReader account/API verification is not part of the MVP.
- Results support sales research and prioritization; they do not replace human review before outreach.
### โ Frequently asked questions
#### Does this find personal emails?
No. The MVP does not invent or guess personal emails.
#### Does this confirm PressReader usage?
Only if the output marks usage as `verified`. Otherwise, the status remains `unknown` or `not_confirmed`.
#### What if a hotel website blocks the fetch?
The Actor labels the official-fetch status separately from resolved facts such as room count.
#### Can I export results?
Yes. Batch runs can produce JSON/CSV-ready output for spreadsheet, CRM review, or outbound workflows.
#### Is this a generic hotel scraper?
No. It is a B2B sales-intelligence tool for prioritizing hotel outreach.
# Actor input Schema
## `hotelName` (type: `string`):
Name of the hotel to analyze.
## `city` (type: `string`):
City where the hotel is located.
## `country` (type: `string`):
Country where the hotel is located.
## `hotelWebsite` (type: `string`):
Official hotel website URL, if available.
## `verifiedRoomCount` (type: `integer`):
Optional verified number of rooms/suites from a cited source.
## `verifiedRoomCountSourceUrl` (type: `string`):
Source URL for the verified room count.
## `verifiedRoomCountSourceLabel` (type: `string`):
Human-readable source label for the verified room count.
## `serviceToSell` (type: `string`):
The B2B service or product you want to sell to the hotel.
## `language` (type: `string`):
Language used for the generated sales intelligence report.
## `targetBuyer` (type: `string`):
Optional target buyer role or department.
## `salesContext` (type: `string`):
Optional context for the sales angle.
## `competitorUrls` (type: `array`):
Optional competitor URLs.
## `includeEmailPitch` (type: `boolean`):
Generate a first outreach email message.
## `includeLinkedInPitch` (type: `boolean`):
Generate a short LinkedIn outreach message.
## `includeCSV` (type: `boolean`):
Write a CSV export to the Actor key-value store.
## `hotels` (type: `array`):
Optional batch of hotel inputs.
## Actor input object example
```json
{
"hotelName": "Six Senses Rome",
"city": "Rome",
"country": "Italy",
"hotelWebsite": "https://www.sixsenses.com/en/hotels/rome",
"serviceToSell": "digital newspapers and magazines for hotel guests",
"language": "English",
"includeEmailPitch": true,
"includeLinkedInPitch": false,
"includeCSV": false
}
```
# Actor output Schema
## `results` (type: `string`):
Structured hotel prospect records in the default dataset.
## `files` (type: `string`):
Generated run artifacts such as CSV exports, summaries, or report files when available.
# 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 = {
"hotelName": "Six Senses Rome",
"city": "Rome",
"country": "Italy",
"hotelWebsite": "https://www.sixsenses.com/en/hotels/rome",
"serviceToSell": "digital newspapers and magazines for hotel guests"
};
// Run the Actor and wait for it to finish
const run = await client.actor("axmaxcoding/smarthotels-sales-opportunity-scanner").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 = {
"hotelName": "Six Senses Rome",
"city": "Rome",
"country": "Italy",
"hotelWebsite": "https://www.sixsenses.com/en/hotels/rome",
"serviceToSell": "digital newspapers and magazines for hotel guests",
}
# Run the Actor and wait for it to finish
run = client.actor("axmaxcoding/smarthotels-sales-opportunity-scanner").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 '{
"hotelName": "Six Senses Rome",
"city": "Rome",
"country": "Italy",
"hotelWebsite": "https://www.sixsenses.com/en/hotels/rome",
"serviceToSell": "digital newspapers and magazines for hotel guests"
}' |
apify call axmaxcoding/smarthotels-sales-opportunity-scanner --silent --output-dataset
```
## MCP server setup
```json
{
"mcpServers": {
"apify": {
"command": "npx",
"args": [
"mcp-remote",
"https://mcp.apify.com/?tools=axmaxcoding/smarthotels-sales-opportunity-scanner",
"--header",
"Authorization: Bearer "
]
}
}
}
```
## OpenAPI specification
```json
{
"openapi": "3.0.1",
"info": {
"title": "SmartHotels Sales Opportunity Scanner",
"description": "Turn hotel prospect lists into evidence-safe B2B sales intelligence with score, fit, room-count evidence, source-backed signals, outreach guidance, and CSV export.",
"version": "0.0",
"x-build-id": "GzSb07HDDGqoBUeFX"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/axmaxcoding~smarthotels-sales-opportunity-scanner/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-axmaxcoding-smarthotels-sales-opportunity-scanner",
"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/axmaxcoding~smarthotels-sales-opportunity-scanner/runs": {
"post": {
"operationId": "runs-sync-axmaxcoding-smarthotels-sales-opportunity-scanner",
"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/axmaxcoding~smarthotels-sales-opportunity-scanner/run-sync": {
"post": {
"operationId": "run-sync-axmaxcoding-smarthotels-sales-opportunity-scanner",
"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": {
"hotelName": {
"title": "Hotel Name",
"type": "string",
"description": "Name of the hotel to analyze."
},
"city": {
"title": "City",
"type": "string",
"description": "City where the hotel is located."
},
"country": {
"title": "Country",
"type": "string",
"description": "Country where the hotel is located."
},
"hotelWebsite": {
"title": "Hotel Website",
"type": "string",
"description": "Official hotel website URL, if available."
},
"verifiedRoomCount": {
"title": "Verified Room Count",
"type": "integer",
"description": "Optional verified number of rooms/suites from a cited source."
},
"verifiedRoomCountSourceUrl": {
"title": "Room Count Source URL",
"type": "string",
"description": "Source URL for the verified room count."
},
"verifiedRoomCountSourceLabel": {
"title": "Room Count Source Label",
"type": "string",
"description": "Human-readable source label for the verified room count."
},
"serviceToSell": {
"title": "Service to Sell",
"type": "string",
"description": "The B2B service or product you want to sell to the hotel."
},
"language": {
"title": "Report Language",
"enum": [
"English",
"Italian",
"Spanish"
],
"type": "string",
"description": "Language used for the generated sales intelligence report.",
"default": "English"
},
"targetBuyer": {
"title": "Target Buyer",
"type": "string",
"description": "Optional target buyer role or department."
},
"salesContext": {
"title": "Sales Context",
"type": "string",
"description": "Optional context for the sales angle."
},
"competitorUrls": {
"title": "Competitor URLs",
"type": "array",
"description": "Optional competitor URLs.",
"items": {
"type": "string"
}
},
"includeEmailPitch": {
"title": "Include Email Pitch",
"type": "boolean",
"description": "Generate a first outreach email message.",
"default": true
},
"includeLinkedInPitch": {
"title": "Include LinkedIn Pitch",
"type": "boolean",
"description": "Generate a short LinkedIn outreach message.",
"default": false
},
"includeCSV": {
"title": "Include CSV",
"type": "boolean",
"description": "Write a CSV export to the Actor key-value store.",
"default": false
},
"hotels": {
"title": "Hotels Batch",
"type": "array",
"description": "Optional batch of hotel inputs.",
"items": {
"type": "object",
"required": [
"hotelName",
"city",
"country",
"serviceToSell"
],
"properties": {
"hotelName": {
"title": "Hotel Name",
"type": "string",
"description": "Name of the hotel to analyze.",
"editor": "textfield"
},
"city": {
"title": "City",
"type": "string",
"description": "City where the hotel is located.",
"editor": "textfield"
},
"country": {
"title": "Country",
"type": "string",
"description": "Country where the hotel is located.",
"editor": "textfield"
},
"hotelWebsite": {
"title": "Hotel Website",
"type": "string",
"description": "Official hotel website URL, if available.",
"editor": "textfield"
},
"verifiedRoomCount": {
"title": "Verified Room Count",
"type": "integer",
"description": "Optional verified number of rooms/suites from a cited source.",
"editor": "number"
},
"verifiedRoomCountSourceUrl": {
"title": "Room Count Source URL",
"type": "string",
"description": "Source URL for the verified room count.",
"editor": "textfield"
},
"verifiedRoomCountSourceLabel": {
"title": "Room Count Source Label",
"type": "string",
"description": "Human-readable source label for the verified room count.",
"editor": "textfield"
},
"serviceToSell": {
"title": "Service to Sell",
"type": "string",
"description": "The B2B service or product you want to sell to the hotel.",
"editor": "textarea"
},
"language": {
"title": "Report Language",
"type": "string",
"description": "Language used for the generated sales intelligence report.",
"enum": [
"English",
"Italian",
"Spanish"
],
"default": "English",
"editor": "select"
}
}
}
}
}
},
"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
}
}
}
}
}
}
}
}
}
}
```