{
"openapi": "3.0.1",
"info": {
"title": "Google Hotels Search Scrapers",
"description": "This actor extracts data from Google Hotels Search, including all information on the screen. Full filter options like price range, rating, and hotel class are supported. Work exactly likes Google Hotels Search on the browser.",
"version": "0.0",
"x-build-id": "4BZhf6tWjwVzDAEGc"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/dan.scraper~google-hotels-search-scrapers/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-dan.scraper-google-hotels-search-scrapers",
"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/dan.scraper~google-hotels-search-scrapers/runs": {
"post": {
"operationId": "runs-sync-dan.scraper-google-hotels-search-scrapers",
"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/dan.scraper~google-hotels-search-scrapers/run-sync": {
"post": {
"operationId": "run-sync-dan.scraper-google-hotels-search-scrapers",
"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": [
"queries",
"checkInDate",
"checkOutDate"
],
"properties": {
"queries": {
"title": "Search Queries",
"type": "array",
"description": "List of Google Hotels search query.",
"items": {
"type": "string"
}
},
"maxPagesPerQuery": {
"title": "Max pages per query",
"minimum": 1,
"type": "integer",
"description": "The maximum number of search result pages crawled for each search query or URL."
},
"csvFriendlyOutput": {
"title": "Output CSV friendly format",
"type": "boolean",
"description": "Include shopping results data, use for CSV format"
},
"countryCode": {
"title": "Country",
"enum": [
"",
"af",
"al",
"dz",
"as",
"ad",
"ao",
"ai",
"aq",
"ag",
"ar",
"am",
"aw",
"au",
"at",
"az",
"bs",
"bh",
"bd",
"bb",
"by",
"be",
"bz",
"bj",
"bm",
"bt",
"bo",
"ba",
"bw",
"bv",
"br",
"io",
"bn",
"bg",
"bf",
"bi",
"kh",
"cm",
"ca",
"cv",
"ky",
"cf",
"td",
"cl",
"cn",
"cx",
"cc",
"co",
"km",
"cg",
"cd",
"ck",
"cr",
"ci",
"hr",
"cu",
"cy",
"cz",
"dk",
"dj",
"dm",
"do",
"ec",
"eg",
"sv",
"gq",
"er",
"ee",
"et",
"fk",
"fo",
"fj",
"fi",
"fr",
"gf",
"pf",
"tf",
"ga",
"gm",
"ge",
"de",
"gh",
"gi",
"gr",
"gl",
"gd",
"gp",
"gu",
"gt",
"gn",
"gw",
"gy",
"ht",
"hm",
"va",
"hn",
"hk",
"hu",
"is",
"in",
"id",
"ir",
"iq",
"ie",
"il",
"it",
"jm",
"jp",
"jo",
"kz",
"ke",
"ki",
"kp",
"kr",
"kw",
"kg",
"la",
"lv",
"lb",
"ls",
"lr",
"ly",
"li",
"lt",
"lu",
"mo",
"mk",
"mg",
"mw",
"my",
"mv",
"ml",
"mt",
"mh",
"mq",
"mr",
"mu",
"yt",
"mx",
"fm",
"md",
"mc",
"mn",
"ms",
"ma",
"mz",
"mm",
"na",
"nr",
"np",
"nl",
"an",
"nc",
"nz",
"ni",
"ne",
"ng",
"nu",
"nf",
"mp",
"no",
"om",
"pk",
"pw",
"ps",
"pa",
"pg",
"py",
"pe",
"ph",
"pn",
"pl",
"pt",
"pr",
"qa",
"re",
"ro",
"ru",
"rw",
"sh",
"kn",
"lc",
"pm",
"vc",
"ws",
"sm",
"st",
"sa",
"sn",
"cs",
"sc",
"sl",
"sg",
"sk",
"si",
"sb",
"so",
"za",
"gs",
"es",
"lk",
"sd",
"sr",
"sj",
"sz",
"se",
"ch",
"sy",
"tw",
"tj",
"tz",
"th",
"tl",
"tg",
"tk",
"to",
"tt",
"tn",
"tr",
"tm",
"tc",
"tv",
"ug",
"ua",
"ae",
"gb",
"us",
"um",
"uy",
"uz",
"vu",
"ve",
"vn",
"vg",
"vi",
"wf",
"eh",
"ye",
"zm",
"zw"
],
"type": "string",
"description": "This param is for the Country (e.g. es for Spain). The values must be lower-cased ISO 3166 country codes supported by Google. By default, the actor uses United States (us).
Notice: To get Google Shopping results from a location, please use UULE code. If you choose countryCode as es without setting locationUule, you will get the results from United States(default search location). To get results from Spain, you need to set locationUule to w+CAIQICIFU3BhaW4="
},
"languageCode": {
"title": "Language",
"enum": [
"",
"af",
"sq",
"sm",
"ar",
"az",
"eu",
"be",
"bn",
"bh",
"bs",
"bg",
"ca",
"zh-CN",
"zh-TW",
"hr",
"cs",
"da",
"nl",
"en",
"eo",
"et",
"fo",
"fi",
"fr",
"fy",
"gl",
"ka",
"de",
"el",
"gu",
"iw",
"hi",
"hu",
"is",
"id",
"ia",
"ga",
"it",
"ja",
"jw",
"kn",
"ko",
"la",
"lv",
"lt",
"mk",
"ms",
"ml",
"mt",
"mr",
"ne",
"no",
"nn",
"oc",
"fa",
"pl",
"pt-BR",
"pt-PT",
"pa",
"ro",
"ru",
"gd",
"sr",
"si",
"sk",
"sl",
"es",
"su",
"sw",
"sv",
"tl",
"ta",
"te",
"th",
"ti",
"tr",
"uk",
"ur",
"uz",
"vi",
"cy",
"xh",
"zu"
],
"type": "string",
"description": "Language for the search results, which is passed to Google Search as the hl URL query parameter. Only set this if you want to use a non-default language for the selected country. The values must be lower-cased ISO 639 language codes supported by Google.",
"default": ""
},
"currency": {
"title": "Displayed Currency",
"enum": [
"",
"DZD",
"ARS",
"AMD",
"AWG",
"AUD",
"AZN",
"BSD",
"BHD",
"BYN",
"BMD",
"BAM",
"BRL",
"GBP",
"BGN",
"XPF",
"CAD",
"CLP",
"CNY",
"COP",
"CRC",
"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",
"USD",
"UAH",
"AED",
"VND"
],
"type": "string",
"description": "Prices are displayed in this currency.",
"default": ""
},
"checkInDate": {
"title": "Check-in Date",
"pattern": "^(\\d{4})-(0[1-9]|1[0-2])-(0[1-9]|[12]\\d|3[01])$",
"type": "string",
"description": "Check-in date for the hotel search. The date format should be YYYY-MM-DD.",
"default": "2025-12-01"
},
"checkOutDate": {
"title": "Check-out Date",
"pattern": "^(\\d{4})-(0[1-9]|1[0-2])-(0[1-9]|[12]\\d|3[01])$",
"type": "string",
"description": "Check-out date for the hotel search. The date format should be YYYY-MM-DD.",
"default": "2025-12-30"
},
"adults": {
"title": "Adults",
"minimum": 1,
"type": "integer",
"description": "Number of adults for the hotel search.",
"default": 2
},
"children": {
"title": "Children",
"minimum": 0,
"type": "integer",
"description": "Number of children for the hotel search.",
"default": 0
},
"childrenAges": {
"title": "Children Ages",
"type": "array",
"description": "List of children ages for the hotel search. Value from 1 to 17",
"default": [],
"items": {
"type": "string"
}
},
"lowestPrice": {
"title": "Lowest Price",
"minimum": 0,
"type": "integer",
"description": "The minimum price of the hotel room.",
"default": 0
},
"highestPrice": {
"title": "Highest Price",
"minimum": 0,
"type": "integer",
"description": "The maximum price of the hotel room."
},
"propertyType": {
"title": "Property Type",
"type": "array",
"description": "Filter the search results by property type. The values must be one of the following: 1 - Apartments, 2 - Bungalows, 3 - Cabins, 4 - Chalets, 5 - Cottages, 6 - Gîtes, 7 - Holiday villages, 8 - Houses, 9 - Houseboats, 10 - Villas, 11 - Other, 12 - Beach hotels, 13 - Boutique hotels, 14 - Hostels, 15 - Inns, 16 - Motels, 17 - Resorts, 18 - Spa hotels, 19 - Bed and breakfasts, 20 - Other, 21 - Apartment hotels, 22 - Minshuku, 23 - Japanese-style business hotels, 24 - Ryokan.",
"items": {
"type": "string",
"enum": [
"",
"1",
"2",
"3",
"4",
"5",
"6",
"7",
"8",
"9",
"10",
"11",
"12",
"13",
"14",
"15",
"16",
"17",
"18",
"19",
"20",
"21",
"22",
"23",
"24"
],
"enumTitles": [
"",
"Apartments",
"Bungalows",
"Cabins",
"Chalets",
"Cottages",
"Gîtes",
"Holiday villages",
"Houses",
"Houseboats",
"Villas",
"Other",
"Beach hotels",
"Boutique hotels",
"Hostels",
"Inns",
"Motels",
"Resorts",
"Spa hotels",
"Bed and breakfasts",
"Other",
"Apartment hotels",
"Minshuku",
"Japanese-style business hotels",
"Ryokan"
]
}
},
"amenities": {
"title": "Amenities",
"type": "array",
"description": "Filter the search results by amenities. The values must be one of the following: 1 - Free parking, 2 - Hot tub, 3 - Parking, 4 - Air-conditioned, 5 - Outdoor pool, 6 - Outdoor grill, 7 - Fitness center, 8 - Restaurant, 9 - Free breakfast, 10 - Fireplace, 11 - Beach access, 12 - Patio or deck, 15 - Kitchen, 16 - Fitness centre, 18 - Cot, 19 - Pet-friendly, 20 - Beach access, 21 - Child-friendly, 22 - Room service, 24 - Pet-friendly, 29 - Free Wi-Fi, 32 - Pool, 35 - Free Wi-Fi, 40 - Air-conditioned, 52 - All-inclusive available, 53 - Wheelchair accessible, 61 - EV charger.",
"items": {
"type": "string",
"enum": [
"",
"1",
"2",
"3",
"4",
"5",
"6",
"7",
"8",
"9",
"10",
"11",
"12",
"15",
"16",
"18",
"19",
"20",
"21",
"22",
"24",
"29",
"32",
"35",
"40",
"52",
"53",
"61"
],
"enumTitles": [
"",
"Free parking",
"Hot tub",
"Parking",
"Air-conditioned",
"Outdoor pool",
"Outdoor grill",
"Fitness center",
"Restaurant",
"Free breakfast",
"Fireplace",
"Beach access",
"Patio or deck",
"Kitchen",
"Fitness centre",
"Cot",
"Pet-friendly",
"Beach access",
"Child-friendly",
"Room service",
"Pet-friendly",
"Free Wi-Fi",
"Pool",
"Free Wi-Fi",
"Air-conditioned",
"All-inclusive available",
"Wheelchair accessible",
"EV charger"
]
}
},
"guestRating": {
"title": "Guest Rating",
"enum": [
"",
"fine",
"good",
"best"
],
"type": "string",
"description": "Filter the search results by guest rating. The values must be one of the following: fine - 3.5+ stars, good - 4.0+ stars, best - 4.5+ stars."
},
"ecoCertified": {
"title": "Eco Certified",
"type": "boolean",
"description": "Filter the search results by eco certified."
},
"hotelClass": {
"title": "Hotel Class",
"type": "array",
"description": "Filter the search results by hotel class. The values must be one of the following: 2 - 2 stars, 3 - 3 stars, 4 - 4 stars, 5 - 5 stars.",
"items": {
"type": "string",
"enum": [
"",
"2",
"3",
"4",
"5"
],
"enumTitles": [
"Any",
"2 stars",
"3 stars",
"4 stars",
"5 stars"
]
}
},
"sortBy": {
"title": "Sort By",
"enum": [
"relevance",
"lowestPrice",
"highestPrice",
"mostReviewed"
],
"type": "string",
"description": "Sort the search results by one of the following options: relevance - Relevance, lowestPrice - Lowest Price, highestPrice - Highest Price, mostReviewed - Most Reviewed.",
"default": "relevance"
}
}
},
"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
}
}
}
}
}
}
}
}
}
}