Listings

get_listings

Returns a minimal list of all listings in your account — just the core fields (id, name, PMS, property, group, parent) plus each listing’s channel/OTA listing IDs (channel_listing_details — the IDs the listing has on Airbnb, Vrbo, Booking.com, and other channels). No metrics or pricing, so it’s fast. Use this first to pick a listing_id and pms_name, then call get_listing_data when you need full records.

Best for: Browsing your portfolio, finding a listing id, or mapping your listings to their channel/OTA IDs.

Example: “Show me all my listings”

get_listing_data

Pulls detailed records for one or more listings. Returns performance metric columns, amenities, groups and tags, sync and hidden flags, and when prices were last refreshed. Heavier than get_listings; supports filtering to one listing, hidden-only-off, or sync-only.

Best for: Deep dives on a specific listing, comparing metrics across properties, or checking sync status.

Example: “Give me occupancy, base price and bedrooms count for Sunset Villa”

update_listing_data

Updates min, base, or max prices, or tags, for one or more listings. Requires OAuth write access — use get_listing_data to read current values before updating.

Best for: Adjusting base pricing or tags from a chat without opening the dashboard.

Example: “Set the base price for Sunset Villa to 250”

map_listings

Maps (links) child listings under a parent listing — parent-child mapping. Use it to group the same property’s listings across channels (Airbnb, Vrbo, Booking.com, …) so they are managed and priced together. By default it only links the listings; optional copy flags (all default false) copy the parent’s min/base/max prices, customizations, group, notes, or tags to the children. Requires OAuth write access.

Best for: Linking a property’s channel listings during onboarding, especially in bulk for large accounts.

Example: “Map the Vrbo listing 12345678 under my Airbnb listing Sunset Villa”

unmap_listings

Unmaps (detaches) listings from their parent-child group so they become standalone again — each keeps its own prices and settings. Unmapping a parent detaches its whole group. Partial success is supported: the response lists which listings were unmapped and which failed. Requires OAuth write access.

Best for: Undoing an incorrect mapping or splitting a group before re-mapping.

Example: “Unmap the Vrbo listing 12345678 from its parent”