> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hasdata.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Booking.com Place API
The Booking.com Place API returns full details for a single Booking.com property along with the list of available room suites for the requested stay dates and guest composition.
HasData is an independent service and is not affiliated with, endorsed by, or sponsored by Booking.com. Booking.com is a trademark of its respective owner. This API works with publicly available data only.
## Get Your API Key
Sign in at [hasdata.com](https://app.hasdata.com/sign-in), go to your account settings, and copy your API key.
All requests must include your key in the `x-api-key` header.
## Request Cost and API Credits
Each request to the Booking.com Place API consumes **API Credits** from your account balance.
* **Cost per request:** 10 API Credits
* Credits are deducted only for successful requests.
* Your total available credits depend on your active plan.
You can use your credits across all HasData APIs. The same credit balance is shared platform-wide.
**Unused credits do not roll over.** Any remaining credits expire at the end of the current billing period.
To monitor your credit usage and remaining balance, sign in to your account dashboard at [app.hasdata.com](https://app.hasdata.com/sign-in).
## Make Your First Request
```bash cURL theme={null}
curl --request GET -G \
--url 'https://api.hasdata.com/scrape/booking/place' \
--data-urlencode 'url=https://www.booking.com/hotel/fr/le-bristol-paris.html' \
--data-urlencode 'checkInDate=2026-06-01' \
--data-urlencode 'checkOutDate=2026-06-05' \
--data-urlencode 'rooms=1' \
--data-urlencode 'adults=2' \
--data-urlencode 'children=0' \
--header 'Content-Type: application/json' \
--header 'x-api-key: '
```
```javascript Node.js theme={null}
const axios = require('axios').default;
const options = {
method: 'GET',
url: 'https://api.hasdata.com/scrape/booking/place',
params: {
url: 'https://www.booking.com/hotel/fr/le-bristol-paris.html',
checkInDate: '2026-06-01',
checkOutDate: '2026-06-05',
rooms: '1',
adults: '2',
children: '0'
},
headers: {'Content-Type': 'application/json', 'x-api-key': ''}
};
try {
const { data } = await axios.request(options);
console.log(data);
} catch (error) {
console.error(error);
}
```
```python Python theme={null}
import requests
url = "https://api.hasdata.com/scrape/booking/place"
querystring = {"url":"https://www.booking.com/hotel/fr/le-bristol-paris.html","checkInDate":"2026-06-01","checkOutDate":"2026-06-05","rooms":"1","adults":"2","children":"0"}
headers = {
"Content-Type": "application/json",
"x-api-key": ""
}
response = requests.get(url, headers=headers, params=querystring)
print(response.json())
```
```php PHP theme={null}
"https://www.booking.com/hotel/fr/le-bristol-paris.html",
"checkInDate" => "2026-06-01",
"checkOutDate" => "2026-06-05",
"rooms" => "1",
"adults" => "2",
"children" => "0",
];
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.hasdata.com/scrape/booking/place?" . http_build_query($params),
CURLOPT_RETURNTRANSFER => true,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"x-api-key: ",
],
]);
$response = curl_exec($curl);
curl_close($curl);
echo $response;
```
```java Java theme={null}
OkHttpClient client = new OkHttpClient();
HttpUrl url = HttpUrl.parse("https://api.hasdata.com/scrape/booking/place")
.newBuilder()
.addQueryParameter("url", "https://www.booking.com/hotel/fr/le-bristol-paris.html")
.addQueryParameter("checkInDate", "2026-06-01")
.addQueryParameter("checkOutDate", "2026-06-05")
.addQueryParameter("rooms", "1")
.addQueryParameter("adults", "2")
.addQueryParameter("children", "0")
.build();
Request request = new Request.Builder()
.url(url)
.get()
.addHeader("Content-Type", "application/json")
.addHeader("x-api-key", "")
.build();
Response response = client.newCall(request).execute();
```
```csharp C# theme={null}
using System.Net.Http;
using System.Web;
var client = new HttpClient();
var query = HttpUtility.ParseQueryString(string.Empty);
query["url"] = "https://www.booking.com/hotel/fr/le-bristol-paris.html";
query["checkInDate"] = "2026-06-01";
query["checkOutDate"] = "2026-06-05";
query["rooms"] = "1";
query["adults"] = "2";
query["children"] = "0";
var url = $"https://api.hasdata.com/scrape/booking/place?{query}";
var request = new HttpRequestMessage(new HttpMethod("GET"), url);
request.Headers.Add("x-api-key", "");
using var response = await client.SendAsync(request);
response.EnsureSuccessStatusCode();
var content = await response.Content.ReadAsStringAsync();
Console.WriteLine(content);
```
```ruby Ruby theme={null}
require 'net/http'
require 'uri'
uri = URI("https://api.hasdata.com/scrape/booking/place")
params = {
"url" => "https://www.booking.com/hotel/fr/le-bristol-paris.html",
"checkInDate" => "2026-06-01",
"checkOutDate" => "2026-06-05",
"rooms" => "1",
"adults" => "2",
"children" => "0",
}
uri.query = URI.encode_www_form(params)
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true
request = Net::HTTP::Get.new(uri)
request["Content-Type"] = 'application/json'
request["x-api-key"] = ''
response = http.request(request)
puts response.read_body
```
```rust Rust theme={null}
use reqwest::blocking::Client;
fn main() -> Result<(), Box> {
let client = Client::new();
let res = client
.get("https://api.hasdata.com/scrape/booking/place")
.query(&[("url", "https://www.booking.com/hotel/fr/le-bristol-paris.html")])
.query(&[("checkInDate", "2026-06-01")])
.query(&[("checkOutDate", "2026-06-05")])
.query(&[("rooms", "1")])
.query(&[("adults", "2")])
.query(&[("children", "0")])
.header("Content-Type", "application/json")
.header("x-api-key", "")
.send()?
.text()?;
println!("{}", res);
Ok(())
}
```
```go Go theme={null}
package main
import (
"fmt"
"io"
"net/http"
"net/url"
)
func main() {
params := url.Values{}
params.Set("url", "https://www.booking.com/hotel/fr/le-bristol-paris.html")
params.Set("checkInDate", "2026-06-01")
params.Set("checkOutDate", "2026-06-05")
params.Set("rooms", "1")
params.Set("adults", "2")
params.Set("children", "0")
u := "https://api.hasdata.com/scrape/booking/place?" + params.Encode()
req, _ := http.NewRequest("GET", u, nil)
req.Header.Add("Content-Type", "application/json")
req.Header.Add("x-api-key", "")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}
```
## API Parameters
| Parameter | Default Value | Required | Description |
| -------------- | ---------------------------------------------------------------------------------------------------------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `url` | [https://www.booking.com/hotel/fr/le-bristol-paris.html](https://www.booking.com/hotel/fr/le-bristol-paris.html) | Yes | Full Booking.com URL of the property page. Only `booking.com` and `www.booking.com` hosts are accepted. |
| `checkInDate` | 2026-06-01 | Yes | Check-in date in `YYYY-MM-DD` format. Must be in the future and earlier than `checkOutDate`. |
| `checkOutDate` | 2026-06-05 | Yes | Check-out date in `YYYY-MM-DD` format. Must be later than `checkInDate`. |
| `rooms` | 1 | Yes | Number of rooms to book. |
| `adults` | 2 | Yes | Number of adult guests across all rooms. |
| `children` | - | Yes | Number of child guests across all rooms (0–10). Pass `0` if there are no children. |
| `childrenAges` | - | No | Comma-separated list of child ages, one entry per child (each `0`–`17`). Required when `children > 0` and the number of ages must equal `children`.
Example: `1,3,7`
|
| `language` | - | No | Language of the Booking.com interface and localized fields in the response. |
| `currency` | - | No | Currency of the prices returned in the response. Use `hotelCurrency` to keep each property's native currency. |