{ "openapi": "3.0.1", "info": { "title": "Google Hotels Scraper", "description": "Scrape Google Hotels: hotel names, nightly and total prices, ratings, reviews, stars, amenities, coordinates, images and the price of every booking site (Booking.com, Expedia, official site...) for any location and dates.", "version": "0.1", "x-build-id": "zxvdCKThQnjhWvIuK" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/atalaia~google-hotels/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-atalaia-google-hotels", "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/atalaia~google-hotels/runs": { "post": { "operationId": "runs-sync-atalaia-google-hotels", "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/atalaia~google-hotels/run-sync": { "post": { "operationId": "run-sync-atalaia-google-hotels", "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": [ "locations" ], "properties": { "locations": { "title": "Locations", "minItems": 1, "type": "array", "description": "Cities, regions or areas to search, exactly as you would type them after \"hotels in\" on Google Hotels. One search per location.", "items": { "type": "string" } }, "checkInDate": { "title": "Check-in date", "pattern": "^(\\d{4}-\\d{2}-\\d{2})?$", "type": "string", "description": "Check-in date (YYYY-MM-DD). Defaults to today + 14 days." }, "checkOutDate": { "title": "Check-out date", "pattern": "^(\\d{4}-\\d{2}-\\d{2})?$", "type": "string", "description": "Check-out date (YYYY-MM-DD). Defaults to check-in + 1 day (today + 15 days). Maximum stay: 30 nights." }, "adults": { "title": "Adults", "minimum": 1, "maximum": 10, "type": "integer", "description": "Number of adult guests.", "default": 2 }, "children": { "title": "Children", "minimum": 0, "maximum": 10, "type": "integer", "description": "Number of children (each child is sent to Google as 10 years old).", "default": 0 }, "currency": { "title": "Currency", "type": "string", "description": "3-letter ISO currency code for prices, e.g. USD, EUR, BRL, JPY.", "default": "USD" }, "language": { "title": "Language", "type": "string", "description": "Google interface language code (hl), e.g. en, pt-BR, es, de, ja. Affects hotel names/descriptions where Google localizes them.", "default": "en" }, "country": { "title": "Country", "type": "string", "description": "Google country code (gl), e.g. us, br, gb, de, jp.", "default": "us" }, "maxResultsPerLocation": { "title": "Max hotels per location", "minimum": 1, "maximum": 500, "type": "integer", "description": "Stop after this many hotels per location. The Actor paginates Google results (about 18 new hotels per page) until this number is reached or results run out.", "default": 50 }, "includeVendorPrices": { "title": "Include booking-site prices", "type": "boolean", "description": "Open each hotel's price page to collect the price offered by every booking site (Booking.com, Expedia, the hotel's own website, ...) plus the street address. Needs one extra request per hotel and is charged as a separate `vendor-prices` event.", "default": true }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Apify Proxy is used by default. You normally don't need to change this.", "default": { "useApifyProxy": 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 }, "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 } } } } } } } } } }