# Hotel Rate Shopping Tool — Compare Competitor Rates

**Use case:** 

Compare room-level Booking.com rates across competitor hotels and dates. Track nightly prices, total stay costs, availability, remaining inventory, sold-out status, refundability, cancellation terms, and meal plans in one rate-shopping table.

## Input

```json
{
  "hotelUrls": [
    {
      "url": "https://www.booking.com/hotel/us/bellagio.html",
      "method": "GET"
    },
    {
      "url": "https://www.booking.com/hotel/us/wynn-las-vegas-boulevard.html",
      "method": "GET"
    },
    {
      "url": "https://www.booking.com/hotel/us/the-venetian-resort-casino.html",
      "method": "GET"
    }
  ],
  "maxProperties": 50,
  "daysAhead": 3,
  "includeSoldOut": true,
  "currency": "USD",
  "minReviewScore": 0,
  "maxReviewScore": 0,
  "adults": 2,
  "children": 0,
  "rooms": 1,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ]
  },
  "useApifyProxy": true,
  "proxyCountries": [
    "US"
  ],
  "concurrency": 3,
  "delayBetweenRequests": 3,
  "includeLosAnalysis": false,
  "includeWholesaleRates": false,
  "tieredCadence": false
}
```

## Output

```json
{
  "hotel_name_clean": {
    "label": "Hotel",
    "format": "string"
  },
  "proxy_country": {
    "label": "Proxy country",
    "format": "string"
  },
  "check_in_date": {
    "label": "Check-in",
    "format": "string"
  },
  "check_out_date": {
    "label": "Check-out",
    "format": "string"
  },
  "room_name_clean": {
    "label": "Room",
    "format": "string"
  },
  "nightly_total_price": {
    "label": "Price/night",
    "format": "number"
  },
  "nightly_base_price": {
    "label": "Base rate",
    "format": "number"
  },
  "taxes_and_fees_total": {
    "label": "Taxes & fees",
    "format": "number"
  },
  "total_stay_price": {
    "label": "Total stay",
    "format": "number"
  },
  "currency": {
    "label": "Currency",
    "format": "string"
  },
  "is_sold_out": {
    "label": "Sold out",
    "format": "boolean"
  },
  "availability_status": {
    "label": "Availability",
    "format": "string"
  },
  "rooms_left": {
    "label": "Rooms left",
    "format": "integer"
  },
  "stock_confidence": {
    "label": "Stock signal",
    "format": "string"
  },
  "is_refundable": {
    "label": "Refundable",
    "format": "boolean"
  },
  "cancellation_policy": {
    "label": "Cancellation policy",
    "format": "string"
  },
  "free_cancellation_until": {
    "label": "Free cancellation",
    "format": "string"
  },
  "is_breakfast_included": {
    "label": "Breakfast",
    "format": "boolean"
  },
  "meal_plan": {
    "label": "Meal plan",
    "format": "string"
  },
  "price_basis": {
    "label": "Price basis",
    "format": "string"
  },
  "scrape_timestamp": {
    "label": "Captured",
    "format": "string"
  }
}
```

## About this Actor

This example demonstrates how to use [Booking.com Room-Level Hotel Price Scraper](https://apify.com/noraview/booking-price-scraper.md) with a specific input configuration. Visit the [Actor detail page](https://apify.com/noraview/booking-price-scraper.md) to learn more, explore other use cases, and run it yourself.


## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
This Task's input is already configured above — use it as-is rather than inventing a new one.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — the [REST API](https://docs.apify.com/api/v2.md).

For full API examples (JavaScript, Python, CLI, MCP, OpenAPI), see this Task's Actor page: https://apify.com/noraview/booking-price-scraper.md

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).