---
title: "Query Listings"
method: GET
path: "/listings"
tags: ["Channels"]
---

# Query Listings

`GET /listings`

Query the listings (third-party properties) synced from the operator's connected channel accounts. A listing is a property as it exists on a specific channel, identified by `listing_id` (the channel-side property id). Filter by `channel_account_id`, `listing_id` and/or `channel_type` to scope results.

## Query parameters

- `channel_account_id` integer
- `listing_id` string
- `channel_type` 'airbnb' | 'booking.com' | 'agoda' | 'expedia' | 'vrbo' | 'trip.com' | 'booking_site' | 'tujia_intl' | 'hostex_direct' | 'tujia' | 'xiaozhu' | 'meituan_bnb' | 'meituan_hotel' | 'muniao' | 'fliggy' | 'zhukeyun' | 'tiktok' | 'xiaohongshu' | 'ctrip' | 'houfy' — The type of the channel. See [Supported Channels](/reference/supported-channels) for more information.
- `offset` integer
- `limit` integer

## Response `200`

A list of listings synced from connected channel accounts.

- object
  - `request_id` string, required — Unique identifier for the request.
  - `error_code` integer, required — Numeric error code representing the status of the response. A value of `200` indicates success. <br> See the [Error Codes](/reference/error-manual#error-codes) section for more information.
  - `error_msg` string, required — Message detailing the status of the response.
  - `data` object, required
    - `listings` object[], required
      - `id` integer — Internal id of the listing record.
      - `listing_id` string — Channel-side listing id. Matches the `listing_id` used in other endpoints.
      - `channel_type` 'airbnb' | 'booking.com' | 'agoda' | 'expedia' | 'vrbo' | 'trip.com' | 'booking_site' | 'tujia_intl' | 'hostex_direct' | 'tujia' | 'xiaozhu' | 'meituan_bnb' | 'meituan_hotel' | 'muniao' | 'fliggy' | 'zhukeyun' | 'tiktok' | 'xiaohongshu' | 'ctrip' | 'houfy' — The type of the channel. See [Supported Channels](/reference/supported-channels) for more information.
      - `channel_account_id` integer — Internal id of the channel account this listing belongs to (from `GET /channel_accounts`).
      - `origin_account_id` string — Account id on the channel side.
      - `url` string, nullable — URL of the listing on the channel's website.
      - `title` string — Listing title as shown on the channel.
      - `cover` string, nullable — Cover image URL for the listing.
      - `inventory` integer — Inventory (number of units) reported by the channel.
      - `shelf_status` 'on' | 'off' | 'deleted' | 'unknown' — Listing shelf status on the channel side.
      - `metadata` object, nullable — Normalized channel-side listing metadata parsed from Hostex's internal cache. Schema varies by channel and is not guaranteed to be stable; commonly includes fields such as `city`, `country_name`, `longitude`, `latitude`, `house_picture_list`, `price_list`, etc. Treat this object as best-effort passthrough data and do not rely on the exact shape.
      - `created_at` string, date-time, nullable — When the listing record was created in Hostex, in ISO 8601 UTC.
      - `updated_at` string, date-time, nullable — Last update time of the listing record, in ISO 8601 UTC.
    - `total` integer, required — Total number of matching listings.

---

[API](https://skmtc.net/hostex/apis/hostex-api.md) · [All operations](https://skmtc.net/hostex/apis/hostex-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/hostex/hostex-api/revisions/a3fa555dee66/schema)