# Booking.com Hotel API (https://www.socialcrawl.dev/platforms/booking/hotel)

> Returns one Booking.com property's catalogue record: address, coordinates, star rating, photos, amenities and the check-in and check-out windows. It does not price a stay (GET /v1/booking/search does) and Booking.com leaves its headline review score out of this record, so place.rating.value and place.reviews_count are null here; the search row and GET /v1/booking/hotel/reviews carry them.

TL;DR: `GET /v1/booking/hotel` 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 |
| --- | --- | --- |
| `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. |

## Code example

```bash
curl -G "https://www.socialcrawl.dev/v1/booking/hotel" \
  --data-urlencode "id=pt/masa-5-de-outubro" \
  -H "x-api-key: sc_YOUR_API_KEY"
```

## FAQ

### How do I get a Booking.com property with an API?

Call GET /v1/booking/hotel and send id or url. The id is the property id as GET /v1/booking/search returns it in place.id, for example pt/masa-5-de-outubro, and the url is a Booking.com property link.

### What does the Booking.com hotel endpoint return?

It returns the property's catalogue record: address, coordinates, star rating, photos, amenities and the check-in and check-out windows.

### Does it include prices?

No. It does not price a stay, and GET /v1/booking/search does.

### Why are the rating and review count empty?

Booking.com leaves its headline review score out of this record, so place.rating.value and place.reviews_count are null here. The search row and GET /v1/booking/hotel/reviews carry them.

### How much does this Booking.com endpoint cost?

Each call costs 1 credit on the standard tier. There is no subscription, and 100 free credits cover 100 calls.

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:

- How do I get Booking.com amenities with an API?
- What does the SocialCrawl Booking.com hotel endpoint return?