How to use Google Hotels Scraper

Step by step: in the Apify Store, over the API, from JavaScript or Python, in n8n, and from AI agents through MCP or LangChain.

$4.49 per 1,000 hotel rows on the Free plan, down to $2.69 on higher plans (live Apify price on 2026-10-31).

1. In the Apify Store (no code)

1. Open arcadium/google-hotels and sign in to Apify (a free account works).
2. Fill in the input form. The fields below are the ones the example uses.
3. Set a maximum cost per run in the run options if you want a hard cap.
4. Start the run. Rows appear in the Output tab as they arrive.
5. Export the dataset as JSON, CSV or Excel, or connect an integration.

Example input:

{
  "locations": [
    "Paris"
  ],
  "maxHotels": 20,
  "checkInDates": [
    "+30d"
  ],
  "nights": [
    2
  ],
  "language": "en",
  "country": "us"
}

2. Over the Apify API

The synchronous endpoint runs the actor and returns its rows in one call (for runs up to about five minutes; use the asynchronous run endpoint for longer ones).

curl -X POST "https://api.apify.com/v2/acts/arcadium~google-hotels/run-sync-get-dataset-items" \
  -H "Authorization: Bearer $APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"locations":["Paris"],"maxHotels":20,"checkInDates":["+30d"],"nights":[2],"language":"en","country":"us"}'

3. From JavaScript

// npm install apify-client
import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: process.env.APIFY_TOKEN });
const run = await client.actor('arcadium/google-hotels').call({
  "locations": [
    "Paris"
  ],
  "maxHotels": 20,
  "checkInDates": [
    "+30d"
  ],
  "nights": [
    2
  ],
  "language": "en",
  "country": "us"
});
const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items);

4. From Python

# pip install apify-client
import os
from apify_client import ApifyClient

client = ApifyClient(os.environ["APIFY_TOKEN"])
run = client.actor("arcadium/google-hotels").call(run_input={
    "locations": ["Paris"],
    "maxHotels": 20,
    "checkInDates": ["+30d"],
    "nights": [2],
    "language": "en",
    "country": "us",
})
items = client.dataset(run["defaultDatasetId"]).list_items().items
print(items)

5. In n8n

Paste this node into a workflow (it is a plain HTTP Request node). Create a Header Auth credential with name Authorization and value Bearer <APIFY_TOKEN>; each returned row becomes one item for the next node.

{
  "nodes": [
    {
      "name": "Run arcadium/google-hotels",
      "type": "n8n-nodes-base.httpRequest",
      "typeVersion": 4,
      "position": [
        0,
        0
      ],
      "parameters": {
        "method": "POST",
        "url": "https://api.apify.com/v2/acts/arcadium~google-hotels/run-sync-get-dataset-items",
        "authentication": "genericCredentialType",
        "genericAuthType": "httpHeaderAuth",
        "sendBody": true,
        "specifyBody": "json",
        "jsonBody": "{\"locations\":[\"Paris\"],\"maxHotels\":20,\"checkInDates\":[\"+30d\"],\"nights\":[2],\"language\":\"en\",\"country\":\"us\"}",
        "options": {
          "timeout": 300000
        }
      }
    }
  ],
  "connections": {}
}

6. From an AI assistant (MCP)

Add Apify’s MCP server to Claude Desktop, Cursor, VS Code or any MCP client, limited to this actor:

{
  "mcpServers": {
    "apify": {
      "url": "https://mcp.apify.com/?tools=arcadium/google-hotels",
      "headers": {
        "Authorization": "Bearer <APIFY_TOKEN>"
      }
    }
  }
}

More on the MCP page.

7. From LangChain

# pip install langchain-apify   (reads APIFY_API_TOKEN from the environment)
from langchain_apify import ApifyActorsTool

tool = ApifyActorsTool("arcadium/google-hotels")
rows = tool.invoke({"run_input": {
    "locations": ["Paris"],
    "maxHotels": 20,
    "checkInDates": ["+30d"],
    "nights": [2],
    "language": "en",
    "country": "us",
}})
# or give `tool` to an agent: create_react_agent(llm, [tool])

Sample output

One row, from the example in the actor’s README. Long text is shortened and lists are cut to two items.

{
  "rowType": "hotel",
  "platform": "google-hotels",
  "entityId": "ChoI_uTZsvz1i6-bARoNL2cvMTFmZHB6eDEwMxAB",
  "name": "The Originals Boutique, Hôtel Maison Montmartre, Paris",
  "googleUrl": "https://www.google.com/travel/hotels/entity/ChoI_uTZsvz1i6-bARoNL2cvMTFmZHB6eDEwMxAB",
  "propertyType": "hotel",
  "hotelClass": 4,
  "rating": 4,
  "reviewCount": 2133,
  "latitude": 48.900537,
  "longitude": 2.336269,
  "amenities": [
    "Free Wi-Fi",
    "Air conditioning"
  ],
  "checkIn": "2026-11-10",
  "checkOut": "2026-11-12",
  "nights": 2,
  "adults": 2,
  "currency": "USD",
  "available": true,
  "pricePerNight": 81.75,
  "totalPrice": 163.5,
  "pricesIncludeTaxes": true,
  "priceBeforeTaxes": 136.25,
  "taxesAndFees": 27.25,
  "deal": "30% less than usual",
  "dealPercent": 30,
  "searchLocation": "Paris",
  "searchRank": 1,
  "totalResults": 15000
}

Schedule it

In Apify Console, create a Task from your input and add a Schedule (for example daily). Each run writes a new dataset; integrations can push the rows to Google Sheets, Slack, a webhook or your database.