Secret Escapes Deal Intelligence Scraper

Extract public luxury travel and hotel deal intelligence from Secret Escapes without logging in.

This Actor monitors public Secret Escapes sale listings and returns structured deal rows: destination, hotel/deal title, sale URL, lead/rack rate display, discount percentage, sale end date, images, badges, facilities, optional public detail-page enrichment, date-specific public price/availability signals, and an optional date grid mode that checks multiple check-in dates to approximate a public availability calendar.

What this Actor is best for

• Luxury travel deal monitoring
• Hospitality price/discount intelligence
• Affiliate/editorial travel research
• Destination deal feeds
• Competitor monitoring for boutique and luxury hotels
• Building alerts for limited-time Secret Escapes campaigns

Availability: what is supported

This Actor now supports date-specific public price and availability signals when you pass both checkin and checkout.

It also supports date grid mode: provide dateGrid: true, startDate, endDate, stayNights, and dateStepDays to run multiple public date searches and output one row per deal/date combination. This gives buyers a calendar-like view of public Secret Escapes availability and price movement without logging in.

For date searches, Secret Escapes' public GraphQL response can return:

• availabilityCheckin and availabilityCheckout
• availabilityOfferId
• totalPriceForDisplay, e.g. £371
• pricePerNightForDisplay, e.g. £186
• priceValueSuffixLabel, e.g. for 1 room, 2 nights
• hasDateSpecificPriceAvailability: true

Important limitation: this is not a full room-level inventory calendar and it does not perform checkout. Exact room selection, member/checkout actions and final booking confirmation remain gated. Every result still includes:

• hasRoomLevelAvailability: false
• requiresLoginForCheckoutAvailability: true

Use this Actor for public date-level deal availability/pricing intelligence, not final booking confirmation.

What data can you extract?

Field	Description
saleId	Secret Escapes sale/deal ID
title	Deal title/editorial headline
destinationName	Hotel or destination display name
city, country, continent	Public location metadata when available
url	Public Secret Escapes deal URL
leadRate, rackRate	Public lead/rack-rate display strings
checkin, checkout input	Optional date search; when provided, public date-level availability/pricing is returned where available
availabilityCheckin, availabilityCheckout, availabilityOfferId	Date-specific public availability match and offer ID
totalPriceForDisplay, pricePerNightForDisplay	Public total and nightly price for requested dates
hasDateSpecificPriceAvailability	Whether Secret Escapes returned date-specific public availability/pricing
dateGridMode, dateGridIndex, dateGridCheckin, dateGridCheckout, dateGridStayNights	Calendar-like grid metadata when date grid mode is enabled
discountPercent	Visible discount percentage
startsAt, endsAt	Sale campaign dates where visible
hasFlightsAvailable	Whether flights are advertised as available
badges	Public labels such as time-limited or flights available
topFacilities	Facilities visible in the public sale data
photoUrls	Public image URLs
description, propertyDetails	Optional detail-page editorial text when includeDetails is enabled
latitude, longitude	Optional detail-page coordinates when visible
availabilityScope	Explicit availability limitation label

Example input

{
  "territory": "UK",
  "query": "Lisbon",
  "dateGrid": true,
  "startDate": "2026-09-10",
  "endDate": "2026-09-17",
  "stayNights": 2,
  "dateStepDays": 2,
  "maxDateSearches": 4,
  "maxItems": 25,
  "includeDetails": true,
  "detailLimit": 10,
  "minDiscountPercent": 20
}

Example output

{
  "saleId": "A24723",
  "source": "Secret Escapes",
  "territory": "UK",
  "title": "Swanky Lisbon stay in the city centre",
  "destinationName": "BessaHotel Liberdade, Lisbon, Portugal",
  "country": "Portugal",
  "url": "https://www.secretescapes.com/bessahotel-liberdade-lisbon-portugal/sale-hotel",
  "discountPercent": 34,
  "leadRate": "£120",
  "rackRate": "£146",
  "availabilityCheckin": "2026-09-10",
  "availabilityCheckout": "2026-09-12",
  "dateGridMode": true,
  "dateGridIndex": 0,
  "dateGridCheckin": "2026-09-10",
  "dateGridCheckout": "2026-09-12",
  "dateGridStayNights": 2,
  "availabilityOfferId": "A22387",
  "totalPriceForDisplay": "£371",
  "pricePerNightForDisplay": "£186",
  "priceValueSuffixLabel": "for 1 room, 2 nights",
  "hasDateSpecificPriceAvailability": true,
  "hasFlightsAvailable": false,
  "availabilityScope": "date_level_public_price_availability_signals",
  "hasRoomLevelAvailability": false,
  "requiresLoginForCheckoutAvailability": true
}

Input parameters

• territory — Secret Escapes territory code. UK is the main tested market.
• query — optional keyword/destination search.
• checkin, checkout — optional YYYY-MM-DD date search. Provide both to return public date-specific total price, nightly price, offer ID and availability signal where available.
• dateGrid — optional calendar-like mode. When true, the Actor generates multiple check-in/check-out searches and returns one row per deal/date combination.
• startDate, endDate — date grid boundaries. Generated checkout dates must be on or before endDate.
• stayNights — nights per generated stay.
• dateStepDays — spacing between generated check-ins. Use 1 for daily, 7 for weekly.
• maxDateSearches — safety cap for generated public date searches.
• maxDealsPerDate — in date grid mode, cap rows kept from each generated date search so the output covers multiple dates instead of filling up on the first date.
• dateGridRequestDelaySecs — polite delay between date grid searches.
• maxItems — maximum number of deal rows.
• pageSize — upstream page size, up to 100.
• offset — pagination offset.
• travelTypes — usually HOTEL_ONLY; WITH_FLIGHTS can return package-style deals.
• withFlights — shortcut to request flight-inclusive deals.
• collections — optional collection codes if known.
• sortBy — optional upstream sort value such as DISCOUNT, PRICE_ASC, PRICE_DESC, NEWEST if supported.
• minPrice, maxPrice — optional upstream price filters.
• minDiscountPercent — post-filter deals by discount.
• includeDetails — fetch public detail pages for descriptions, coordinates and full facilities.
• detailLimit — cap optional detail-page enrichment.
• detailRequestDelaySecs — polite delay between optional detail requests.
• requestTimeoutSecs — HTTP timeout.

Pricing note

This Actor is lighter than full hotel inventory-calendar scrapers because it does not fetch room-level calendars. It is now stronger than a pure deal feed because it can run date-specific Secret Escapes searches and a calendar-like date grid, returning public total/nightly prices across multiple check-in dates. Recommended launch pricing remains around $0.006 per output row if pay-per-event monetization is enabled; in date grid mode, each deal/date combination is one row.

Compliance and source note

The Actor only uses public, non-login Secret Escapes pages and public GraphQL requests observed from public pages. It does not log in, bypass authentication, or perform checkout/member actions. You are responsible for complying with applicable laws and terms in your jurisdiction. This Actor is not affiliated with, endorsed by, or sponsored by Secret Escapes.