{ "openapi": "3.0.1", "info": { "title": "Google Hotels Search Scraper", "description": "Scrape Google Hotels search results — hotel name, rating, reviews count, price, check-in/out dates, URL, address. Search by query+location+dates or direct URL. MCP-ready.", "version": "0.7", "x-build-id": "CZqRo1Ga3QDEdgJrO" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/khadinakbar~google-hotels-search-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-khadinakbar-google-hotels-search-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/khadinakbar~google-hotels-search-scraper/runs": { "post": { "operationId": "runs-sync-khadinakbar-google-hotels-search-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/khadinakbar~google-hotels-search-scraper/run-sync": { "post": { "operationId": "run-sync-khadinakbar-google-hotels-search-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": { "query": { "title": "Search query", "type": "string", "description": "Hotel search phrase, for example 'luxury hotels' or 'hotels near central park'. Combine with location for best results. Leave blank if providing a direct googleHotelsUrl." }, "location": { "title": "Location", "type": "string", "description": "City, region, or landmark to search in, for example 'New York', 'Paris', or 'Times Square'. Combined with query to form the Google Hotels search." }, "googleHotelsUrl": { "title": "Google Hotels URL (optional override)", "type": "string", "description": "Paste a full google.com/travel/hotels URL to override the query/location fields. Useful for replaying a specific search with filters already set." }, "checkIn": { "title": "Check-in date (YYYY-MM-DD)", "type": "string", "description": "Arrival date in YYYY-MM-DD format, for example 2026-10-01. Controls which nightly prices Google Hotels shows. Leave blank for anytime search." }, "checkOut": { "title": "Check-out date (YYYY-MM-DD)", "type": "string", "description": "Departure date in YYYY-MM-DD format, for example 2026-10-03. Must be after checkIn. Leave blank for anytime search." }, "adults": { "title": "Adults", "minimum": 1, "maximum": 16, "type": "integer", "description": "Number of adult guests. Affects price and availability shown on Google Hotels. Default 2.", "default": 2 }, "children": { "title": "Children", "minimum": 0, "maximum": 10, "type": "integer", "description": "Number of child guests. Default 0.", "default": 0 }, "language": { "title": "Language code", "type": "string", "description": "Google search language code, for example 'en' for English or 'fr' for French. Controls the language of hotel names and review labels returned.", "default": "en" }, "countryCode": { "title": "Country / market code", "type": "string", "description": "Two-letter ISO country code for the Google Hotels market, for example 'us', 'gb', or 'de'. Affects currency, prices, and property availability shown. EU and UK markets route through US proxy exits for reliable access (Google consent wall); result lists stay localized to the selected market while nightly prices may quote in USD.", "default": "us" }, "maxResults": { "title": "Max results", "minimum": 1, "maximum": 500, "type": "integer", "description": "Maximum number of hotel rows to save per run. Default 60. Each saved row triggers one hotel-result PPE event. Raise for deeper coverage; lower for quick price checks.", "default": 60 }, "maxPages": { "title": "Max pages to crawl", "minimum": 1, "maximum": 20, "type": "integer", "description": "Maximum number of Google Hotels result pages to process. Default 3. Each page typically surfaces 20-30 hotels. Raise for comprehensive city coverage.", "default": 3 }, "useApifyProxy": { "title": "Use Apify proxy", "type": "boolean", "description": "Route requests through Apify proxy for anti-bot resilience. Recommended on. Disable only for local testing without a proxy subscription.", "default": true }, "apifyProxyGroups": { "title": "Proxy groups", "type": "array", "description": "Apify proxy group(s) to use. Default ['RESIDENTIAL']. Use RESIDENTIAL for best Google compatibility.", "default": [ "RESIDENTIAL" ], "items": { "type": "string" } }, "maxConcurrency": { "title": "Max concurrency", "minimum": 1, "maximum": 10, "type": "integer", "description": "Maximum parallel requests. Default 3. Lower if you see HTTP 429 blocks; raise for faster pagination.", "default": 3 } } }, "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 } } } } } } } } } }