{ "openapi": "3.0.1", "info": { "title": "Hotel Leads Scraper: Emails, Phones & Booking Engine", "description": "Find hotels on Google Hotels and get what each hotel's own website publishes: e-mails, phones, social profiles and booking engine, plus OTA rate parity (who undercuts the hotel). Filter by stars and reviews, skip chains. Reads only what robots.txt allows. Not affiliated with Google.", "version": "0.2", "x-build-id": "tIAoWb6aAwIJBz91J" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/aleksandrbooking~hotel-leads-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-aleksandrbooking-hotel-leads-scraper", "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/aleksandrbooking~hotel-leads-scraper/runs": { "post": { "operationId": "runs-sync-aleksandrbooking-hotel-leads-scraper", "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/aleksandrbooking~hotel-leads-scraper/run-sync": { "post": { "operationId": "run-sync-aleksandrbooking-hotel-leads-scraper", "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": { "searchQueries": { "title": "Searches", "type": "array", "description": "What you would type into Google Hotels: \"hotels in Batumi\", \"boutique hotels in Lisbon\", \"hostels near Shinjuku\". Google lists about twenty hotels per request in a changing order, so each text is asked a few times and the new hotels are kept; a big city gives fifty to sixty hotels per text at most. Use several texts, or switch on \"Wider search\", to cover more.", "default": [], "items": { "type": "string" } }, "hotels": { "title": "Hotels", "type": "array", "description": "Hotels to look up by name with the city (\"Hilton Batumi\") or by their Google Hotels link (the address that has /entity/ in it). A name that matches no hotel well enough is listed in FAILED_HOTELS and is not charged.", "default": [], "items": { "type": "string" } }, "moreCoverage": { "title": "Wider search", "type": "boolean", "description": "For each text of the form \" in \" also search the place for hostels, guest houses, boutique hotels, resorts, bed and breakfasts and 3, 4 and 5 star hotels. Every text reaches hotels the others do not, at the cost of more requests to Google.", "default": false }, "maxHotelsPerSearch": { "title": "Hotels per search", "minimum": 1, "maximum": 200, "type": "integer", "description": "How many hotels to collect for each search text. Twenty is one page from Google; a text with fewer hotels than this returns them all.", "default": 40 }, "maxLeads": { "title": "Leads per run", "minimum": 1, "maximum": 2000, "type": "integer", "description": "The most hotels the run delivers (and charges for). The run stops reading when it has this many.", "default": 100 }, "minStars": { "title": "Minimum stars", "minimum": 1, "maximum": 5, "type": "integer", "description": "Leave out hotels with fewer stars, and hotels with no star class." }, "minRating": { "title": "Minimum guest rating", "minimum": 1, "maximum": 5, "type": "number", "description": "Leave out hotels rated below this on Google (1 to 5)." }, "minReviews": { "title": "Minimum reviews", "minimum": 0, "type": "integer", "description": "Leave out hotels with fewer Google reviews than this." }, "maxReviews": { "title": "Maximum reviews", "minimum": 0, "type": "integer", "description": "Leave out hotels with more Google reviews than this: a way to keep small, independent hotels." }, "excludeChains": { "title": "Leave out hotel chains", "type": "boolean", "description": "Leave out hotels whose website is a chain's (Hilton, Marriott, IHG, Accor, Wyndham and about seventy more). A chain hotel's site is never read in any case: it is one site for hundreds of hotels.", "default": false }, "excludeVacationRentals": { "title": "Leave out vacation rentals", "type": "boolean", "description": "Leave out listings of rental marketplaces (apartments and houses listed by their platform, with no hotel of their own on the map). Their website is a marketplace page, so there are no contacts to find.", "default": true }, "onlyWithEmail": { "title": "Only hotels with an e-mail address", "type": "boolean", "description": "Deliver (and charge for) only hotels whose own site published an e-mail address. The run reads up to four times the limit to fill it.", "default": false }, "onlyUndercut": { "title": "Only hotels undercut by a booking site", "type": "boolean", "description": "Deliver only hotels for which a booking site charges at least 1% less than the hotel's own site for the stay below. Needs \"Read each hotel's Google page\".", "default": false }, "readWebsites": { "title": "Read each hotel's own website", "type": "boolean", "description": "Read the hotel's home page and up to two contact pages (when its robots.txt allows) for e-mail addresses, phones, social profiles, the booking engine and facts about the site. Off: only what Google knows.", "default": true }, "readGooglePages": { "title": "Read each hotel's Google page", "type": "boolean", "description": "One request per hotel to its Google Hotels page: the phone, the address and every booking site's price, which is what rate parity is computed from. Off: only what the search card shows (no phone, no address, no parity).", "default": true }, "checkInDate": { "title": "Check-in date", "type": "string", "description": "YYYY-MM-DD. Leave empty to use \"Days ahead\". The stay is only used to compare prices (rate parity); it does not change which hotels are found." }, "checkOutDate": { "title": "Check-out date", "type": "string", "description": "YYYY-MM-DD. Leave empty to use \"Nights\" after the check-in date." }, "daysAhead": { "title": "Days ahead", "minimum": 0, "maximum": 330, "type": "integer", "description": "Check-in this many days from today, when no check-in date is given. A scheduled run with this set always prices a stay the same distance away.", "default": 14 }, "nights": { "title": "Nights", "minimum": 1, "maximum": 30, "type": "integer", "description": "How many nights, when no check-out date is given.", "default": 2 }, "adults": { "title": "Adults", "minimum": 1, "maximum": 6, "type": "integer", "description": "Adults in the room.", "default": 2 }, "currency": { "title": "Currency", "enum": [ "ALL", "DZD", "ARS", "AMD", "AWG", "AUD", "AZN", "BSD", "BHD", "BYN", "BMD", "BAM", "BRL", "GBP", "BGN", "CAD", "XPF", "CLP", "CNY", "COP", "CRC", "HRK", "CUP", "CZK", "DKK", "DOP", "EGP", "EUR", "GEL", "HKD", "HUF", "ISK", "INR", "IDR", "IRR", "ILS", "JMD", "JPY", "JOD", "KZT", "KWD", "LBP", "MKD", "MYR", "MXN", "MDL", "MAD", "TWD", "NZD", "NOK", "OMR", "PKR", "PAB", "PEN", "PHP", "PLN", "QAR", "RON", "RUB", "SAR", "RSD", "SGD", "ZAR", "KRW", "SEK", "CHF", "THB", "TRY", "UAH", "AED", "USD", "VND" ], "type": "string", "description": "The currency the rate check is given in. It matters only for the prices and the rate parity of each row.", "default": "USD" }, "country": { "title": "Country of sale", "type": "string", "description": "The two-letter country code Google sells the stay in: us, gb, de, ge. It decides which booking sites Google lists and what they charge, so rate parity is read for that market. It is not the country of the hotel.", "default": "us" }, "language": { "title": "Language", "enum": [ "en", "en-GB", "de", "fr", "es", "it", "pt-BR", "pt-PT", "nl", "pl", "cs", "tr", "ru", "uk", "ja", "ko", "zh-CN", "zh-TW", "ar", "he", "th", "vi", "id", "sv", "da", "no", "fi", "el", "ro", "hu" ], "type": "string", "description": "The language of the texts Google returns (hotel descriptions and labels).", "default": "en" }, "concurrency": { "title": "Requests in parallel (Google)", "minimum": 1, "maximum": 10, "type": "integer", "description": "How many requests to Google run at the same time. Hotel sites are read eight at a time, one request at a time per site.", "default": 5 }, "customData": { "title": "Custom data", "type": "object", "description": "Any JSON. It is copied onto every row, so rows of different runs can be told apart after merging." }, "proxy": { "title": "Proxy", "type": "object", "description": "Apify datacenter proxies are the default and what this Actor is priced on; they are used for Google. Hotel sites are read from the Actor's own address. Residential groups are not available here; a run that asks for one is refused in the first seconds. For your own proxies choose Custom proxies and supply them.", "default": { "useApifyProxy": true } }, "dryRun": { "title": "Dry run (owner only)", "type": "boolean", "description": "Produce data without charging events. Honored only for runs started by the Actor owner; ignored for everyone else.", "default": false } } }, "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 }, "PROXY_UNBLOCKER_UNITS": { "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 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }