# Booking Prices API (booking.prices)

- Canonical page: [https://everyinfra.com/en/booking-api/prices](https://everyinfra.com/en/booking-api/prices?utm_medium=ai_doc&utm_campaign=page_md)
- Endpoint: POST https://api.everyinfra.com/api/v1/social with {"platform": "booking", "action": "prices", "params": {...}}
- Price: $0.001389 per call ($1.39 per 1,000 requests); failed calls and empty results are not charged
- Returns: list
- Mode: sync; add "mode": "async" for slow tasks

## Health

- Live health (24h percent, hourly and daily trends): https://api.everyinfra.com/api/v1/social/availability?platform=booking&action=prices

## Parameters

| name | type | required | default | description |
|---|---|---|---|---|
| url | not declared | yes | not declared | Specifies the full URL to a single property page, preferably using the /hotel/ path format. Used by profile to fetch details, reviews to retrieve property reviews, and prices to check room rates. Destination search URLs are not supported. |
| adults | integer | no | not declared | Specifies the adult guest count for price queries, accepting an integer and defaulting to 2. Used as a price query parameter only; does not cap returned room options or initiate a booking. Search operates with a fixed count of 2 adults. |
| check_in | not declared | no | not declared | Specifies the check-in date in YYYY-MM-DD format. Search and profile actions require both check_in and check_out to send stay dates. For prices, this acts as the start date when start_date is omitted. Does not create bookings. |
| currency | not declared | no | not declared | Specifies the currency for property price displays, defaulting to USD. Accepts listed lowercase codes for search and profile actions, and uppercase three-letter codes for prices. This parameter does not change EveryInfra API billing. |
| days | integer | no | not declared | Specifies how many calendar days ahead to query for prices, defaulting to 7 and constrained to 1–30 (values outside this range are clamped). Determines the query date window, not the length of stay for individual room rates. |
| rooms | integer | no | not declared | Specifies the number of rooms for price queries, accepting an integer and defaulting to 1. Determines the requested room count rather than the number of returned room options. Search operates with a fixed count of 1 room. |
| start_date | not declared | no | not declared | Specifies the start date for daily price lookups in prices using YYYY-MM-DD format. Overrides check_in when both are provided. Does not represent review posting dates or property opening dates. |
| limit | integer (1–) | no | not declared | The most rows to return in this call, an integer of 1 or more. The default applies when you leave it out, and a call can return fewer rows. |

## Response fields (items in `results`)

| field | meaning |
|---|---|
| id | The record's unique ID on the platform. Unique only within one platform; IDs can repeat across platforms. |
| url | Link to the record on the platform. |
| hotel_name | platform-native meaning |
| room_name | Room type name. |
| check_in | platform-native meaning |
| check_out | platform-native meaning |
| price | Price as a number without a currency symbol; see currency. |
| original_price | platform-native meaning |
| discount_percent | platform-native meaning |
| currency | Currency code of the price (for example CNY, USD). If price is present but currency is null, do not assume a currency. |
| taxes_included | platform-native meaning |
| is_sold_out | platform-native meaning |
| availability_status | platform-native meaning |
| min_stay | platform-native meaning |
| bed_type | platform-native meaning |
| max_guests | platform-native meaning |
| room_size_sqm | platform-native meaning |
| meal_plan | platform-native meaning |
| is_breakfast_included | platform-native meaning |
| is_refundable | platform-native meaning |
| rate_options_count | platform-native meaning |
| platform | Source platform identifier, the same as platform in the request (for example xiaohongshu, tiktok). |
| rooms_left | platform-native meaning |
| room_view | platform-native meaning |

## Example

```bash
curl -X POST 'https://api.everyinfra.com/api/v1/social' \
  -H "Authorization: Bearer $EVERYINFRA_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "platform": "booking",
  "action": "prices",
  "params": {
    "url": "https://www.booking.com/hotel/jp/park-hyatt-tokyo.html"
  }
}'
```

```python
import os
import requests

response = requests.post(
    "https://api.everyinfra.com/api/v1/social",
    headers={"Authorization": f"Bearer {os.environ['EVERYINFRA_API_KEY']}"},
    json={
        "platform": "booking",
        "action": "prices",
        "params": {
            "url": "https://www.booking.com/hotel/jp/park-hyatt-tokyo.html",
        },
    },
    timeout=120,
)
print(response.status_code)
print(response.json())
```

## Response example

Real response to the example request above, captured 2026-11-07T14:47:42Z. `results` and `count` are real with personal information (names, handles, avatars, profile links, contact details) removed; the list keeps the first 2 of 56. `id`, `billing` and `quota` differ on every call, so only their shape is shown.

```text
{
  "id": "req_…",
  "platform": "booking",
  "action": "prices",
  "results": [
    {
      "id": "17981011",
      "url": "https://www.booking.com/hotel/jp/park-hyatt-tokyo.html",
      "hotel_name": "Park Hyatt Tokyo",
      "room_name": "Premier King Room",
      "check_in": "2026-11-07",
      "check_out": "2026-11-08",
      "currency": "USD",
      "is_sold_out": true,
      "availability_status": "sold_out",
      "max_guests": 3,
      "room_size_sqm": 65,
      "platform": "booking"
    },
    {
      "id": "17981012",
      "url": "https://www.booking.com/hotel/jp/park-hyatt-tokyo.html",
      "hotel_name": "Park Hyatt Tokyo",
      "room_name": "King Room with City View",
      "check_in": "2026-11-07",
      "check_out": "2026-11-08",
      "currency": "USD",
      "is_sold_out": true,
      "availability_status": "sold_out",
      "max_guests": 2,
      "room_size_sqm": 45,
      "platform": "booking"
    }
  ],
  "count": 56,
  "billing": {
    "charged": …,
    "charged_usd": …,
    "balance_after_usd": …,
    …
  },
  "quota": { … }
}
```

## Also

- Capability catalog (no key): https://api.everyinfra.com/api/v1/social/catalog?platform=booking
- OpenAPI: https://everyinfra.com/openapi.json · Agents guide: https://everyinfra.com/agents.md
