> For the complete documentation index, see [llms.txt](https://developer.gotadi.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.gotadi.com/vietnamese/doi-tac-b2b2c/phuong-thuc-api/hotel/api/api-content-properties.md).

# API Content Properties

Endpoint: `content/properties`

Danh sách master **đang hoạt động** của một quốc gia, duyệt theo cursor. Mỗi khách sạn chỉ có `masterId`, `name`, `address`, `latitude`, `longitude` — muốn content đầy đủ thì gọi `content/property`.

Gọi lại với `cursor = nextCursor` đến khi `nextCursor` là `null`.

**Request**

| Field         | Kiểu      | Bắt buộc | Mô tả                                                                                 |
| ------------- | --------- | -------- | ------------------------------------------------------------------------------------- |
| `countryCode` | string(2) | ✔        | ISO 3166-1 alpha-2, ví dụ `VN`                                                        |
| `provider`    | enum      |          | `ALL` (mặc định), `HMS`, `SUPPLIER`. Master có cả hai nguồn xuất hiện ở cả hai bộ lọc |
| `size`        | int       |          | 1–500, mặc định 100                                                                   |
| `cursor`      | string    |          | `nextCursor` của trang trước; bỏ trống ở trang đầu                                    |
| `language`    | enum      |          | `vi` \| `en`                                                                          |

```json
{ "countryCode": "VN", "provider": "ALL", "size": 100, "language": "vi" }
```

**Response**

| Field          | Kiểu           | Mô tả                       |
| -------------- | -------------- | --------------------------- |
| `properties[]` | array          | Danh sách khách sạn rút gọn |
| `nextCursor`   | string \| null | `null` khi đã hết danh mục  |

```json
{
  "properties": [
    {
      "masterId": "30715",
      "name": "Khách sạn Mẫu Đà Nẵng",
      "address": {
        "line": "12 Võ Nguyên Giáp", "city": "Đà Nẵng",
        "province": "Đà Nẵng", "country": "VN"
      },
      "latitude": 16.0612,
      "longitude": 108.2471
    }
  ],
  "nextCursor": "eyJvZmZzZXQiOjEwMH0"
}
```

{% hint style="warning" %}
Từ bản 1.1.0, `content/properties` **không còn nhận `masterIds`**, `page`, `total`, `modifiedSince`. Duyệt danh mục bằng `cursor`; chi tiết một khách sạn lấy từ `content/property`.
{% endhint %}
