Google Hotels Search Scraper

Pricing

from $0.01 / 1,000 results

Try for free

Go to Apify Store

Google Hotels Search Scraper

Try for free

Extract comprehensive hotel data from Google Hotels including prices, ratings, amenities, property details, and images. Supports advanced filtering, vacation rentals, localization, and multi-page pagination. Ideal for market research, price monitoring, and travel applications.

Pricing

from $0.01 / 1,000 results

Rating

5.0

(3)

Developer

John

Maintained by Community

Actor stats

Bookmarked

Total users

Monthly active users

17 hours ago

Last modified

Categories

Travel

Real estate

E-commerce

You can access the Google Hotels Search Scraper programmatically from your own applications by using the Apify API. You can also choose the language preference from below. To use the Apify API, you’ll need an Apify account and your API token, found in Integrations settings in Apify Console.

Python

JavaScript

CLI

OpenAPI

HTTP

MCP

{
  "openapi": "3.0.1",
  "info": {
    "version": "0.0",
    "x-build-id": "pfMXOdiMefL6O1Jpe"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/johnvc~google-hotels-search-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-johnvc-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/johnvc~google-hotels-search-scraper/runs": {
      "post": {
        "operationId": "runs-sync-johnvc-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/johnvc~google-hotels-search-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-johnvc-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": {
          "q": {
            "title": "Search Query",
            "type": "string",
            "description": "Search query string for hotels (e.g., 'hotels in Paris', 'New York hotels'). Required if property_token is not provided. Either 'q' or 'property_token' must be provided (validation enforced at runtime)."
          },
          "property_token": {
            "title": "Property Token",
            "type": "string",
            "description": "Google Hotels property token for a specific hotel property. Use this to get detailed information about a specific property. Required if 'q' is not provided. Either 'q' or 'property_token' must be provided (validation enforced at runtime)."
          },
          "gl": {
            "title": "Country Code",
            "pattern": "^[a-z]{2}$",
            "type": "string",
            "description": "Country code for localization (ISO 3166-1 alpha-2, e.g., 'us', 'fr', 'uk'). Optional. Defaults to 'us' if not specified."
          },
          "hl": {
            "title": "Language Code",
            "pattern": "^[a-z]{2}$",
            "type": "string",
            "description": "Language code for localization (ISO 639-1, e.g., 'en', 'fr', 'es'). Optional. Defaults to 'en' if not specified."
          },
          "currency": {
            "title": "Currency",
            "pattern": "^[A-Z]{3}$",
            "type": "string",
            "description": "Currency code for prices (ISO 4217, e.g., 'USD', 'EUR', 'GBP'). Optional. Defaults based on country if not specified."
          },
          "check_in_date": {
            "title": "Check-in Date",
            "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
            "type": "string",
            "description": "Check-in date in YYYY-MM-DD format (e.g., '2025-12-13'). Recommended when using search query. Optional."
          },
          "check_out_date": {
            "title": "Check-out Date",
            "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
            "type": "string",
            "description": "Check-out date in YYYY-MM-DD format (e.g., '2025-12-14'). Recommended when using search query. Optional."
          },
          "adults": {
            "title": "Number of Adults",
            "minimum": 1,
            "maximum": 50,
            "type": "integer",
            "description": "Number of adult guests. Optional. Defaults to 2 if not specified.",
            "default": 2
          },
          "children": {
            "title": "Number of Children",
            "minimum": 0,
            "maximum": 50,
            "type": "integer",
            "description": "Number of child guests. Optional. Defaults to 0 if not specified.",
            "default": 0
          },
          "children_ages": {
            "title": "Children Ages",
            "pattern": "^\\d+(,\\d+)*$",
            "type": "string",
            "description": "Comma-separated list of children ages as integers (e.g., '5,8,12'). Required if children > 0. Optional otherwise."
          },
          "min_price": {
            "title": "Minimum Price",
            "pattern": "^\\d+(\\.\\d+)?$",
            "type": "string",
            "description": "Minimum price filter in the specified currency. Optional. Must be a valid number (e.g., '50' or '99.99'). Default: '0.00' (no minimum).",
            "default": "0.00"
          },
          "max_price": {
            "title": "Maximum Price",
            "pattern": "^\\d+(\\.\\d+)?$",
            "type": "string",
            "description": "Maximum price filter in the specified currency. Optional. Must be a valid number (e.g., '200' or '299.99'). Default: '0.00' (no maximum).",
            "default": "0.00"
          },
          "stars": {
            "title": "Star Ratings",
            "pattern": "^[1-5](,[1-5])*$",
            "type": "string",
            "description": "Comma-separated list of star ratings to filter by (e.g., '3,4,5' for 3, 4, or 5 star hotels). Each value must be an integer between 1 and 5. Optional."
          },
          "amenities": {
            "title": "Amenities",
            "pattern": "^\\d+(,\\d+)*$",
            "type": "string",
            "description": "Comma-separated list of amenity IDs to filter by (integer IDs). Optional. Check Google Hotels API documentation for available amenity IDs."
          },
          "hotel_class": {
            "title": "Hotel Class",
            "pattern": "^\\d+(,\\d+)*$",
            "type": "string",
            "description": "Comma-separated list of hotel class IDs to filter by (integer IDs). Optional. Check Google Hotels API documentation for available class IDs."
          },
          "guest_rating": {
            "title": "Minimum Guest Rating",
            "pattern": "^\\d+(\\.\\d+)?$",
            "type": "string",
            "description": "Minimum guest rating filter (0.0 to 5.0). Optional. Must be a valid number (e.g., '4.0' or '4.5'). Default: '0.0' (no minimum).",
            "default": "0.0"
          },
          "property_type": {
            "title": "Property Type",
            "pattern": "^\\d+(,\\d+)*$",
            "type": "string",
            "description": "Comma-separated list of property type IDs to filter by (integer IDs). Optional. Check Google Hotels API documentation for available property type IDs."
          },
          "vacation_rentals": {
            "title": "Include Vacation Rentals",
            "type": "boolean",
            "description": "Whether to include vacation rentals in search results. Optional. Defaults to false.",
            "default": false
          },
          "rental_type": {
            "title": "Rental Type",
            "pattern": "^\\d+(,\\d+)*$",
            "type": "string",
            "description": "Comma-separated list of rental type IDs to filter by (integer IDs). Only relevant when vacation_rentals is true. Optional."
          },
          "bedrooms": {
            "title": "Number of Bedrooms",
            "minimum": 1,
            "maximum": 20,
            "type": "integer",
            "description": "Number of bedrooms filter for vacation rentals. Only relevant when vacation_rentals is true. Optional."
          },
          "bathrooms": {
            "title": "Number of Bathrooms",
            "minimum": 1,
            "maximum": 20,
            "type": "integer",
            "description": "Number of bathrooms filter for vacation rentals. Only relevant when vacation_rentals is true. Optional."
          },
          "max_pages": {
            "title": "Maximum Pages",
            "minimum": 0,
            "type": "integer",
            "description": "Maximum number of pages to fetch (1-indexed). Set to 0 for no limit (fetch all available pages). Default: 1. Each page is charged separately.",
            "default": 1
          },
          "output_file": {
            "title": "Output File",
            "type": "string",
            "description": "Optional filename to save results as JSON. If not provided, will auto-generate based on query and timestamp."
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}

Google Hotels Search Scraper OpenAPI definition

OpenAPI is a standard for designing and describing RESTful APIs, allowing developers to define API structure, endpoints, and data formats in a machine-readable way. It simplifies API development, integration, and documentation.

OpenAPI is effective when used with AI agents and GPTs by standardizing how these systems interact with various APIs, for reliable integrations and efficient communication.

By defining machine-readable API specifications, OpenAPI allows AI models like GPTs to understand and use varied data sources, improving accuracy. This accelerates development, reduces errors, and provides context-aware responses, making OpenAPI a core component for AI applications.

You can download the OpenAPI definitions for Google Hotels Search Scraper from the options below:

OpenAPI.json

If you’d like to learn more about how OpenAPI powers GPTs, read our blog post.

You can also check out our other API clients:

Google Hotels Search Scraper API in Python

Google Hotels Search Scraper API in JavaScript

Google Hotels Search Scraper API through CLI

Google Hotels Search Scraper API

Google Hotels Scraper

martin.forejt/google-hotels-scraper

Google Hotels Scraper is an actor for extracting prices from Google search results.

Martin Forejt

343

3.7

Google Hotels Scraper for Price Extraction

dainty_screw/google-hotels-scraper-for-price-extraction

Looking to stay competitive in the hotel industry? A Google Hotels Scraper helps you easily pull pricing data from Google search results, allowing you to analyze trends and adjust your pricing strategy for better results.

codemaster devops

5.0

Google Hotels Scraper

simpleapi/google-hotels-scraper

Get comprehensive hotel data from Google Hotels—listings, prices, ratings, reviews, photos, and amenities. Clean, structured output makes it perfect for travel research, dynamic pricing models, and marketplace data enrichment.

SimpleAPI

Google Hotels Scraper

scrapio/google-hotels-scraper

Collect detailed Google Hotels information automatically—hotel names, prices, availability, reviews, amenities, and maps data. Great for travel agencies, analysts, and developers needing structured hotel datasets for reporting or automation.

Scrapio

Hotels.com Scraper 🏨

easyapi/hotels-com-scraper

Scrape detailed hotel listings from Hotels.com including prices, ratings, amenities, and images. Perfect for price monitoring, market analysis, and travel research.

EasyApi

5.0

Hotels.com Review Scraper 🏨

easyapi/hotels-com-review-scraper

Scrape detailed hotel reviews from Hotels.com, including ratings, review text, management responses, and reviewer information. Perfect for hotel market research and customer sentiment analysis.

EasyApi

5.0

Google Travel Hotel Prices

vittuhy/google-travel-hotel-prices

This actor extracts real-time pricing information for a given hotel across multiple dates and provides comprehensive price comparisons from various booking providers.

Vít Tuhý

5.0

Hotels Com Email Scraper

scraper-mind/hotels-com-email-scraper

Hotels.com Email Scraper – Effortlessly scrape Hotels.com emails based on keywords & location! 🔍 Supports custom email domains & proxy usage for seamless extraction. Perfect for lead generation, marketing & market research. Download data in JSON, CSV, Excel.