Input Schema Example

Example payload for search_listings:

{
  "query": "quiet private room near coworking",
  "location": "Lisbon, Portugal",
  "location_id": 123,
  "date_from": "2026-09-01",
  "date_to": "2026-12-01",
  "price_min": 800,
  "price_max": 1800,
  "price_currency": "EUR",
  "room_type": "private",
  "bathroom": "private",
  "amenities": ["wifi", "coworking", "gym"],
  "community": ["digital_nomads", "students"],
  "no_security_deposit": true,
  "free_cancellation": true,
  "rating_min": 4,
  "sort_by": "best_match",
  "page": 1,
  "limit": 10
}

Output Contract

{
  "items": [
    {
      "id": 12345,
      "unique_id": "listing-007847",
      "slug": "lisbon-coliving-home",
      "title": "Private room in Lisbon coliving home",
      "url": "https://coliving.com/spaces/lisbon-coliving-home",
      "location": "Lisbon, Portugal",
      "monthly_price_from": 950,
      "currency": "EUR",
      "room_types": ["private"],
      "available_from": "2026-09-01",
      "minimum_stay_months": 1,
      "rating": 4.7,
      "review_count": 28,
      "trust_signals": ["verified_host", "free_cancellation"],
      "summary": "Good fit for quiet remote workers..."
    }
  ],
  "pagination": {
    "current_page": 1,
    "per_page": 10,
    "total": 84
  },
  "applied_filters": {
    "location_id": 123,
    "location_name": "Lisbon, Portugal",
    "community": ["digital_nomads"],
    "community_ids": "5"
  }
}

{
  "unique_id": "listing-007847",
  "slug": "lisbon-coliving-home",
  "title": "Private room in Lisbon coliving home",
  "url": "https://coliving.com/spaces/listing-007847",
  "location": "Lisbon, Portugal",
  "description": "Bright private room in a calm shared home...",
  "description_community": "Residents are mostly remote workers...",
  "description_neighborhood": "Walking distance to cafes and transit...",
  "monthly_price_from": 950,
  "currency": "EUR",
  "security_deposit": {
    "required": false,
    "amount": 0,
    "type": null,
    "apply_after": 0
  },
  "room_types": ["private"],
  "room_summaries": [
    {
      "room_type": "private",
      "available_from": "2026-09-01",
      "min_price": 950,
      "max_occupancy": 1
    }
  ],
  "amenities": ["High-speed WiFi", "Workspace"],
  "available_from": "2026-09-01",
  "minimum_stay_months": 1,
  "rating": 4.7,
  "review_count": 28,
  "trust_signals": ["verified_host", "free_cancellation"],
  "summary": "Great fit for quiet remote workers...",
  "booking_rules": null,
  "contract_type": "monthly",
  "host": {
    "is_elite_host": true,
    "instant_booking": false,
    "pay_at_property": false
  }
}