What format is the data returned in?

Responses are JSON. Each one contains the extracted data plus a _metadata block with the request ID and execution time.

What are the rate limits for the Booking.com Hotel Details API?

Up to 60 requests per minute, 1,000 per hour and 10,000 per day. Contact us if you need higher limits.

Can I run long requests in the background?

Yes. Add ?async=true to receive a job_id immediately, then poll /api/v1/jobs/ / until the status is COMPLETED.

Can I send a large list of requests at once?

Yes. Upload a CSV file with one request per row and the Booking.com Hotel Details API runs them in the background within 24 hours, at 50% of the normal price for each successful row. Use "Upload file" in the Playground or add ?batch=true to the API call.

Do I need to manage proxies or browsers?

No. DataGuru runs the infrastructure, proxies and retries. You only send an HTTP request with your API key.

Travel API · Live

Booking.com Hotel Details API

Get a Booking.com property from its URL, including description, address, star rating, review scores and featured reviews, facilities, house rules, photos, room types and, for given dates, the available offers with prices.

No credit card required · Pay only for what you use

Price: $0.0022 / req
Rate limit: 60 req/min
Output: Structured JSON
Modes: Sync & async

POSThttps://api.dataguru.cc/api/v1/booking/hotels/details

curl -X POST "https://api.dataguru.cc/api/v1/booking/hotels/details" \
  -H "Authorization: Api-Key YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"adults": "2", "checkin": "example", "checkout": "example", "currency": "USD", "hotel_url": "example", "location": "US", "rooms": "1"}'

Response · 200 OK

{
  "hotel_id": "1234567890",
  "name": "string",
  "url": "https://example.com/...",
  "property_type": "string",
  "star_rating": 0.0,
  "brands": [
    "string"
  ],
  "description": "string",
  "address": {
    "full": "string",
    "short": "string",
    "city": "string",
    "postal_code": "string",
    "country": "string",
    "country_code": "string"
  },
  "latitude": 0.0,
  "longitude": 0.0,
  "reviews": {
    "score": 0.0,
    "score_word": "string",
    "count": 0,
    "subscores": [
      {
        "name": "string",
        "key": "string",
        "score": 0.0,
        "count": 0
      }
    ],
    "featured_reviews": [
      {
        "review_id": "1234567890",
        "guest_name": "string",
        "guest_country": "string",
        "score": 0.0,
        "title": "string",
        "positive": "string",
        "negative": "string",
        "date": "2026-01-01T12:00:00Z",
        "traveller_type": "string",
        "room_type": "string"
      }
    ]
  },
  "popular_facilities": [
    "string"
  ],
  "highlights": [
    {
      "name": "string",
      "details": [
        "string"
      ]
    }
  ],
  "photos": [
    "string"
  ],
  "house_rules": {
    "checkin_from": "string",
    "checkin_until": "string",
    "checkout_from": "string",
    "checkout_until": "string",
    "min_checkin_age": 0,
    "pets": "string",
    "children_allowed": false,
    "cribs_allowed": false,
    "extra_beds_allowed": false,
    "accepted_cards": [
      "string"
    ]
  },
  "fine_print": [
    "string"
  ],
  "languages_spoken": [
    "string"
  ],
  "meals": [
    {
      "type": "string",
      "price": "string",
      "style": [
        "string"
      ],
      "cuisine": [
        "string"
      ],
      "score": 0.0
    }
  ],
  "hotel_currency": "string",
  "rooms": [
    {
      "room_id": "1234567890",
      "name": "string",
      "description": "string",
      "size_m2": 0.0,
      "bed_options": [
        "string"
      ],
      "photos": [
        "string"
      ],
      "amenities": [
        "string"
      ]
    }
  ],
  "stay": {
    "checkin": "string",
    "checkout": "string",
    "nights": 0,
    "sold_out": false
  },
  "offers": [
    {
      "block_id": "1234567890",
      "room_id": "1234567890",
      "room_name": "string",
      "max_guests": 0,
      "price": {
        "total": 0.0,
        "total_formatted": "string",
        "currency": "USD",
        "original_total": 0.0,
        "original_total_formatted": "string",
        "per_night": 0.0
      },
      "conditions": [
        "string"
      ],
      "free_cancellation": false,
      "breakfast_included": false,
      "no_prepayment": false,
      "rooms_available": 0
    }
  ],
  "lowest_price": 0.0,
  "time_taken": 0.0,
  "_metadata": {
    "request_id": "3f6c1a2e-8b4d-4c1e-9a7f-2d5e6b7c8d9e",
    "execution_time_ms": 842,
    "endpoint": "Booking.com Hotel Details",
    "mode": "live",
    "format": "json",
    "timestamp": "2026-01-01T12:00:00+00:00"
  }
}

Data

Booking.com Hotel Details API response (structured JSON)

Every response follows the same schema, so you can map it once and rely on it.

Response fields

hotel_idnameurlproperty_typestar_ratingbrandsdescriptionaddresslatitudelongitudereviewspopular_facilitieshighlightsphotoshouse_rulesfine_printlanguages_spokenmealshotel_currencyroomsstayofferslowest_pricetime_taken

Request parameters

Name	Type	Description
adults	integer	Number of adult guests (default 2).
checkin	string	Optional check-in date (YYYY-MM-DD) to get room offers and prices.
checkout	string	Optional checkout date (YYYY-MM-DD). Defaults to one night after check-in.
currency	string	Three-letter currency code for prices (default USD).
hotel_urlrequired	string	Full Booking.com hotel URL (e.g. https://www.booking.com/hotel/sg/marina-bay-sands.html).
location	string	Two-letter country code to fetch the page from (default US).
rooms	integer	Number of rooms (default 1).

Features

Booking.com Hotel Details API features that make scraping easy

No proxies or blocks to manage

DataGuru handles proxies, retries and anti-bot measures for you. You just send a request.

Clean, structured JSON

Every response uses the same 24 fields, so your parser never breaks.

One simple request

Send hotel_url and get results back. No browser automation or HTML parsing on your side.

Sync or async

Get the data in the response, or add ?async=true and poll the job for long-running requests.

Built to scale

Up to 60 requests per minute and 10,000 per day on this endpoint.

Pay only for what you use

No subscription or monthly minimum. Usage is deducted from your prepaid balance.

Use cases

What you can build with the Booking.com Hotel Details API

Data pipelines

Feed fresh, structured data straight into your warehouse or ETL jobs.

Dashboards & reporting

Keep internal dashboards current without manual exports.

Product features

Power features in your app with data you would otherwise have to scrape.

Research & analysis

Collect the dataset you need for analysis in minutes.

Monitoring & alerts

Poll on a schedule and react when something changes.

AI & LLM workflows

Ground models and agents in live, structured data.

Who it's for

Built for teams of every size and background

Data engineers
Product teams
Analysts
Startups
Agencies
Researchers
Automation builders
AI teams

Get started

Start using the Booking.com Hotel Details API in minutes

1
Create a free account
Sign up in seconds and get $1.00 of free balance to test with.
2
Copy your API key
Generate a key in the Developer Portal and send it in the Authorization header.
3
Send a request
Call POST /api/v1/booking/hotels/details with your parameters.
4
Get structured JSON
Use the response straight away in your app, spreadsheet or pipeline.

Pricing

Transparent & simple pricing

No subscription, no monthly minimum. Add funds to your balance and pay only for the requests you make.

Pay as you go

Booking.com Hotel Details

$0.0022 / req

$1.00 free balance on sign-up
60 requests per minute
10,000 requests per day
Sync and async requests

FAQ

Frequently asked questions

The Booking.com Hotel Details API costs $0.0022 per successful request, deducted from your prepaid balance. There is no subscription or monthly minimum. New accounts get $1.00 of free balance to try it.

More APIs

Other APIs you might need

Travel

Try the Booking.com Hotel Details API for free!

Create an account and get $1.00 of free balance to test it. No credit card required.