RealtyCrawl
Booking.com Apartments platformBooking.com Apartments

Read a dated partial hotel offer

Fresh Booking.com hotel-level price observation for this account’s retained Paris stay, explicit future1–30 nights,two adults,no children/infants/pets,one room,USD,no locale. Fully dated URL binds guest context. Reported base plus combined taxes/fees must reconcile. Completeness stays partial: unique bookable room/rate, all mandatory charges and cancellation are unestablished. No booking/payment/price guarantee. Costs50 credits;errors/replay0.

Get an API keyRead the docs

Use a resource previously observed by this account. Check live capabilities for accepted source scope before calling.

Try this operation

Selectors expire after 24 hours. Preserve source meanings and inspect response warnings.

Booking.com Apartments API
1 endpoint documented
View docs
POST/v1/stays/sty_booking_32a2ae1bf067e0b6d465dc70/quoteGet API key
curl -X POST 'https://realtycrawl.dev/v1/stays/sty_booking_32a2ae1bf067e0b6d465dc70/quote' \
  -H "x-api-key: $REALTYCRAWL_API_KEY" \
  -H "content-type: application/json" \
  -d '{"check_in":"2026-12-01","check_out":"2026-12-03","guests":{"adults":2},"currency":"USD"}'
API key required
// Live requests require a RealtyCrawl API key.
// Copy the request to your backend and set REALTYCRAWL_API_KEY.
// Check source and operation availability before running a request.

Request and response

Illustrative contract examples; source availability and values can change.

Request

curl --request POST 'https://realtycrawl.dev/v1/stays/sty_booking_32a2ae1bf067e0b6d465dc70/quote' \
  --header "x-api-key: $REALTYCRAWL_API_KEY" \
  --header 'X-Max-Credits: 50' \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: YOUR_IDEMPOTENCY_KEY' \
  --data '{"check_in":"2026-12-01","check_out":"2026-12-03","guests":{"adults":2},"currency":"USD"}'

Illustrative response

{
  "data": {
    "stay_id": "sty_booking_32a2ae1bf067e0b6d465dc70",
    "check_in": "2026-12-01",
    "check_out": "2026-12-03",
    "guests": {
      "adults": 2
    },
    "total": {
      "amount": "628.64",
      "currency": "USD",
      "kind": "unknown"
    },
    "fees": [],
    "taxes_included": true,
    "price_completeness": "partial",
    "cancellation_text": null,
    "quoted_at": "2026-01-01T12:00:00Z",
    "source": {
      "platform": "booking",
      "provider": "example",
      "observed_at": "2026-01-01T12:00:00Z",
      "access_class": "public_portal"
    }
  },
  "meta": {
    "request_id": "example_request",
    "schema_version": "1.0.0",
    "generated_at": "2026-01-01T12:00:00Z",
    "completeness": "unknown",
    "sources": []
  }
}
FAQ

Have a question?
We got answers

Source scope and credit handling

Contact us
Does this establish current availability or value?

Read the operation-specific source limits above. Calendar status is not occupancy or a booking guarantee. Dated hotel prices are partial offer observations. Zillow identity is source-scoped, without cadastral or cross-portal matching. Comparable homes are unadjusted provider recommendations; their price meaning is unknown and they are not verified sales or appraisals.

How are credits handled?

Source calls cost 50 credits. Retained property and associated-advertisement reads cost 1. Errors and existing idempotent replays cost zero. A replay is a prior response snapshot and can outlive selector retention.