# Booking.com Hotel Rooms API (https://www.socialcrawl.dev/platforms/booking/hotel-rooms) > Returns every offer a Booking.com property has for one stay, one item per offer (a room type at one rate): the room's name, size, beds, facilities and photos, the guests and rooms the offer is priced for, the price of the stay to the cent with the price a night, the discount, and each tax and fee and whether it is included, the meal plan, the cancellation and prepayment terms with the last day to cancel free, and a Booking.com link with the offer selected. `matches_requested_group` says whether an offer fits the whole party you sent, or is null when Booking.com does not say: offers can be priced for one room even when you ask for more. `data.property` and `data.stay` give the property and the stay as priced. Identify the property by `id` (as GET /v1/booking/search returns it) or `url`. A property link that does not open answers a refunded 503. Results are cached for 5 minutes. TL;DR: `GET /v1/booking/hotel/rooms` costs 1 credit per call and returns SocialCrawl's unified JSON schema. Single x-api-key auth, 100 free credits on signup. ## Parameters | Parameter | Required | Description | | --- | --- | --- | | `check_in` | yes | Check-in date, YYYY-MM-DD. | | `check_out` | yes | Check-out date, YYYY-MM-DD, after check_in. | | `id` | no | The Booking.com property id as GET /v1/booking/search returns it in place.id, for example pt/masa-5-de-outubro. Send id or url. | | `url` | no | A Booking.com property link, for example https://www.booking.com/hotel/pt/masa-5-de-outubro.html. | | `adults` | no | Adults, 1 to 30 (default 2). | | `children_ages` | no | Each child's age, 0 to 17, comma-separated, for example 5,8. Omit for no children. | | `rooms` | no | Rooms, 1 to 30 (default 1). | | `currency` | no | Currency for prices, for example USD, EUR or GBP (default USD). (AUD \| BRL \| CAD \| CHF \| CNY \| CZK \| DKK \| EUR \| GBP \| HKD \| HUF \| INR \| JPY \| KRW \| MXN \| NOK \| NZD \| PLN \| RON \| SEK \| SGD \| THB \| TRY \| USD \| ZAR) | | `language` | no | Language for room names and terms, for example en-gb or de-de (default en-us). (en-us \| en-gb \| de-de \| es-es \| fr-fr \| it-it \| nl-nl \| pt-br \| ja-jp \| ko-kr \| pl-pl \| ru-ru \| tr-tr \| zh-cn) | ## Code example ```bash curl -G "https://www.socialcrawl.dev/v1/booking/hotel/rooms" \ --data-urlencode "check_in=2026-12-15" \ --data-urlencode "check_out=2026-12-18" \ --data-urlencode "id=pt/masa-5-de-outubro" \ -H "x-api-key: sc_YOUR_API_KEY" ``` ## FAQ ### What does the Booking.com Hotel Rooms API return? Returns a Booking.com property's bookable offers for a stay, each with its room, beds and facilities, the price with taxes and discount, the meal plan and cancellation terms. The response uses the same JSON envelope as every SocialCrawl endpoint, with the data, credits_used and request_id fields. ### When should I use the Booking.com Hotel Rooms endpoint? Use it to compare a hotel's room rates for your dates, check cancellation and breakfast terms, or track a property's prices for a stay. ### How much does the Booking.com Hotel Rooms API cost? Each call costs 1 credit, so the 100 free credits every new account gets cover 100 calls. Credits for failed or empty calls are refunded automatically, and there is no subscription. ### What parameters does the Booking.com Hotel Rooms API need? The required parameters are check_in (check-in date, YYYY-MM-DD), check_out (check-out date, YYYY-MM-DD, after check_in). Identify the target with one of id, url. It also accepts 7 optional parameters, all listed on this page. ### How do I call the Booking.com Hotel Rooms API? Send a GET request to https://www.socialcrawl.dev/v1/booking/hotel/rooms?check_in=2026-12-15&check_out=2026-12-18&id=pt%2Fmasa-5-de-outubro with your API key in the x-api-key header. An Authorization: Bearer header works too. See the full Booking.com API: https://www.socialcrawl.dev/platforms/booking ## Pricing - Standard endpoints: 1 credit per call - Advanced endpoints: 5 credits per call - Premium endpoints: 10 credits per call - 100 free credits on signup, no credit card required. Cached responses cost 0 credits. Credit packs never expire. - Full pricing: https://www.socialcrawl.dev/pricing ## Explore with AI Questions this API answers, phrased for an AI assistant: - What does the SocialCrawl Booking.com Hotel Rooms API return? - How do I get Booking.com Hotel Rooms data with the SocialCrawl API?