Competitor Rate API

This documentation covers the endpoints available in Innkeeper's Competitor Rate Tracking API. The API enables hotel owners to monitor competitor rates from Booking.com and receive notifications when rates change.

Add Competitor Hotel#

Adds a competitor hotel to your tracking list.

Payload:

{
  "hotel_name": "Exact Hotel Name from Booking.com"
}

Description:

• You must copy and paste the hotel's exact name from Booking.com for accurate results.
• The API performs a fuzzy search and sets the competitor to the closest match.
• If no close match is found, the API will return an error.

Response (Success - 200):

{
  "status": "success",
  "matched_name": "Hotel California Downtown LA",
  "competitor_id": "comp_12345"
}

Response (Error - 404):

{
  "status": "error",
  "message": "Hotel not found. Please ensure the hotel name matches exactly the name listed on Booking.com."
}

Fetch Competitor Rates#

Returns the latest known rates for a specific competitor hotel.

Query Parameters:

• date (ISO string, optional) - Defaults to today if not specified.

Description:

• Returns the latest known rates for a specific competitor hotel.
• Rates are grouped by room type and may vary by date.

Response (Success - 200):

{
  "competitor_id": "comp_12345",
  "hotel_name": "Hotel California Downtown LA",
  "date": "2025-04-11",
  "currency": "USD",
  "rates": [
    {
      "room_type": "Standard Queen Room",
      "price": 139.99
    },
    {
      "room_type": "Deluxe King Suite",
      "price": 189.50
    }
  ]
}

Response (Error - 404):

{
  "status": "error",
  "message": "Competitor not found. Please verify the competitor_id."
}

Real-time Rate Updates#

For real-time updates when competitor rates change, use our webhook system. This enables you to build event-driven integrations that automatically respond to market changes.

See our Webhooks documentation for detailed information on setting up and processing webhook events.