# Booking 主页或对象详情 API (booking.profile)

- Canonical page: [https://everyinfra.com/booking-api/profile](https://everyinfra.com/booking-api/profile?utm_medium=ai_doc&utm_campaign=page_md)
- Endpoint: POST https://api.everyinfra.com/api/v1/social with {"platform": "booking", "action": "profile", "params": {...}}
- Price: $0.001389 per call ($1.39 per 1,000 requests); failed calls and empty results are not charged
- Returns: single object
- 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=profile

## Parameters

| name | type | required | default | description |
|---|---|---|---|---|
| url | not declared | yes | not declared | Booking 单个住宿的完整页面链接，建议使用 /hotel/ 路径。profile 查住宿资料，reviews 查该住宿点评，prices 查房型价格；不要将目的地搜索页当作单个酒店链接。 |
| check_in | not declared | no | not declared | 入住日期，YYYY-MM-DD。search / profile 仅在同时提供 check_in 和 check_out 时传入日期；prices 中作为 start_date 未提供时的起始日期，不创建订单。 |
| check_out | not declared | no | not declared | 退房日期，YYYY-MM-DD，应与 check_in 一起提供且晚于入住日期。只填这一项不会让 search / profile 带上完整入住区间。 |
| currency | enum: aed / ars / aud / azn / bgn / bhd / brl / cad / chf / clp / cny / cop / czk / dkk / egp / eur / fjd / gbp / gel / hkd / huf / idr / ils / inr / jod / jpy / krw / kwd / kzt / mdl / mxn / myr / nad / nok / nzd / omr / pln / qar / ron / rub / sar / sek / sgd / thb / try / twd / uah / usd / xof / zar | no | not declared | 住宿价格展示币种，默认 USD。search / profile 接受本接口列出的币种代码；prices 建议使用大写三字母代码。它不改变 EveryInfra 的 API 计费币种。 |
| lang | enum: ar / bg / ca / cs / da / de / el / engb / enus / es / esar / et / fi / fr / he / hr / hu / id / is / it / ja / ko / lt / lv / ms / nl / no / pl / ptbr / ptpt / ro / ru / sk / sl / sr / sv / th / tl / tr / uk / vi / zhcn / zhtw | no | not declared | 住宿页面信息语言，默认英式英语；engb / enus 为英式 / 美式英语，zhcn / zhtw 为简体 / 繁体中文。不要直接套用 en 或 zh；此参数不负责翻译 reviews 的点评正文。 |

## Response fields (items in `results`)

| field | meaning |
|---|---|
| id | 该记录在原平台上的唯一标识。仅在同一平台内唯一，跨平台可能重复。 |
| name | 名称。用于账号/商品/商家类能力，指该对象本身的名字。 |
| type | 记录类型，取值随能力而定（如 video / image / text）。 |
| url | 该记录在原平台上的可访问链接。 |
| text | 正文内容，已去除 HTML 标签，全文返回、不截断（个别平台的列表结果本身只有摘要，以该平台的字段说明为准）。 |
| stars | 酒店星级（1–5），是官方评定的硬件等级，**与住客评分 rating 不是一回事**。 |
| rating | 评分。**分制随平台而异**，同一行的 `rating_scale` 给出该平台满分 (多数是 5，Booking/豆瓣/爱奇艺/NAVER 是 10)。跨平台比较前必须先按 rating_scale 换算。直接比数字会得出反的结论。 |
| rating_scale | 上一列 `rating` 的满分。5 表示五星制、10 表示十分制。只在该行有 rating 时出现。 |
| rating_label | 评分的文字档位（如 Wonderful / Very good），由 score 分段而来。 |
| review_count | 评价条数，用于商品/商家类能力。null 表示不公开，不等于 0。 |
| price | 价格数值，不含货币符号；币种见 currency。 |
| currency | 价格币种代码（如 CNY、USD）。price 存在但 currency 为 null 时不要假定币种。 |
| breakfast | 早餐说明（含/不含/需加购）。 |
| hotel_chain | 所属连锁品牌，独立酒店为 null。 |
| check_in_date | 本次查询的入住日期。 |
| check_out_date | 本次查询的退房日期。 |
| address | 详细地址，原文透传。 |
| city | 城市名，用原平台的语言书写，未做中英归一。 |
| country | 国家或地区。可能是全称也可能是 ISO 代码，取决于平台，未归一。 |
| latitude | 纬度。 |
| longitude | 经度。 |
| image_url | 图片链接。多图能力可能返回 image_urls 数组。 |
| platform | 数据来源平台标识，与请求里的 platform 一致（如 xiaohongshu、tiktok）。 |
| category_ratings | 分项评分列表，每项含名称（name，如清洁度、位置）和分数（score）；没有时不出现这个字段。 |
| image_urls | 图片链接数组，按平台展示顺序；没有图片时不出现这个字段。 |
| facilities | 设施与服务名称列表，按页面分组顺序展开；没有时不出现这个字段。 |

## 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": "profile",
  "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": "profile",
        "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-09-26T08:56:04Z. `results` and `count` are real with personal information (names, handles, avatars, profile links, contact details) removed. `id`, `billing` and `quota` differ on every call, so only their shape is shown.

```text
{
  "id": "req_…",
  "platform": "booking",
  "action": "profile",
  "results": {
    "id": 179810,
    "name": "Park Hyatt Tokyo",
    "type": "hotel",
    "url": "https://www.booking.com/hotel/jp/park-hyatt-tokyo.en-gb.html",
    "text": "Get the celebrity treatment with world-class service at Park Hyatt TokyoPark Hyatt Tokyo welcomes you home, thoughtfully crafting each moment with intuitive care to ensure every stay feels personally tailored. Located in Shinjuku, west Tokyo, Park Hyatt Tokyo occupies the 39th to…",
    "stars": 5,
    "rating": 9.2,
    "review_count": 128,
    "breakfast": "Buffet",
    "address": "Tokyo-to, Tokyo, Shinjuku-ku, Nishishinjuku 3-7-1-2, Japan",
    "city": "Tokyo",
    "country": "jp",
    "latitude": "35.684871080031755",
    "longitude": "139.69104677438736",
    "image_url": "https://cf.bstatic.com/xdata/images/hotel/max1024x768/909678791.jpg?k=bd70c52af1180cbfa82618a22e8b6db4b822c98835618ea713199b0d4636b55f&o=",
    "platform": "booking",
    "category_ratings": [
      {
        "name": "Location",
        "score": 9.1
      },
      {
        "name": "Cleanliness",
        "score": 9.7
      },
      {
        "name": "Value for money",
        "score": 8.5
      }
    ],
    "image_urls": [
      "https://cf.bstatic.com/xdata/images/hotel/max1024x768/909678791.jpg?k=bd70c52af1180cbfa82618a22e8b6db4b822c98835618ea713199b0d4636b55f&o=&hp=1",
      "https://cf.bstatic.com/xdata/images/hotel/max1024x768/909677947.jpg?k=0132e551e1b3f34b69767d6416d778dee86bfd324025f3d0a6d39a2b21e005ca&o=&hp=1",
      "https://cf.bstatic.com/xdata/images/hotel/max1024x768/110318598.jpg?k=180b52ab1b8a3cdda7a6a014c2068e381bcfa4dc8573036a19ce57241e6b1018&o=&hp=1"
    ],
    "facilities": [
      "4 restaurants",
      "Parking",
      "Private bathroom"
    ],
    "rating_scale": 10
  },
  "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
