Listing Search API

Search listings with structured filters. Context-aware pricing applied automatically.

---

Structured Search

POST /api/v1/crs/listings
Content-Type: application/json

{
  "rawParams": [
    { "filterName": "channelId", "filterValues": ["B2C"] },
    { "filterName": "city", "filterValues": ["Goa"] },
    { "filterName": "checkInDate", "filterValues": ["2026-05-15"] },
    { "filterName": "checkOutDate", "filterValues": ["2026-05-17"] },
    { "filterName": "adults", "filterValues": ["4"] },
    { "filterName": "children", "filterValues": ["2"] },
    { "filterName": "propertyType", "filterValues": ["Villa"] },
    { "filterName": "petFriendly", "filterValues": ["true"] },
    { "filterName": "maxPrice", "filterValues": ["20000"] }
  ]
}

Response

{
  "singleListings": [
    {
      "listingId": "lst_abc",
      "title": "Nimishka Villa",
      "coverPicture": "https://cdn.elivaas.com/villa.jpg",
      "propertyType": "VILLA",
      "brand": "priv\u00e9",
      "badges": [
        { "name": "Best Seller" },
        { "name": "In Demand" }
      ],
      "adults": 6,
      "bedrooms": 3,
      "bathrooms": 2,
      "unitCount": 4,
      "locality": "Chattyan",
      "city": "Kasauli",
      "state": "Himachal Pradesh",
      "rating": 4.6,
      "tags": ["Pvt Pool", "Garden Area", "Scenic Views", "Game Room"],
      "selectedProperties": [
        { "propertyId": "prop_1", "title": "Deluxe Room", "quantity": 2 }
      ],
      "price": {
        "total": 32800,
        "perNight": 16400,
        "totalBeforeDiscount": 38000,
        "totalSaving": 5200,
        "discountPercent": 14
      },
      "offerTitles": ["10% off with Visa"],
      "cancellationPlans": [
        {
          "id": "plan_flex",
          "name": "Flexible",
          "planType": "FLEXIBLE",
          "cancellationSummary": "Free cancellation till 7 days before check-in",
          "hasDiscount": false,
          "totalAfterDiscount": 32800,
          "perNightAfterDiscount": 16400
        }
      ]
    }
  ],
  "combinations": []
}

---

Available Filters

filterName	Type	Example	Description
channelId	string	B2C	Sales channel
city	string[]	["Goa"]	Filter by city
state	string[]	["Himachal Pradesh"]	Filter by state
locality	string[]	["Kasauli"]	Filter by locality
checkInDate	string	2026-05-15	YYYY-MM-DD
checkOutDate	string	2026-05-17	YYYY-MM-DD
adults	int	4	Required adults
children	int	2	Required children
pets	int	1	Required pets
propertyType	string[]	["Villa"]	Villa, Apartment, Resort
brand	string[]	["priv\u00e9"]	Filter by brand
amenities	string[]	["Pool","Wifi"]	Required amenities
tags	string[]	["Scenic Views"]	Required tags
petFriendly	boolean	true	Pet-friendly only
stressProperties	boolean	true	Stressed/deal properties
minPrice	int	5000	Min per-night price
maxPrice	int	20000	Max per-night price
minBedrooms	int	2	Minimum bedrooms
minRating	double	4.0	Minimum rating
searchQuery	string	"Nimishka"	Text search on name
allowCombination	boolean	true	Allow multi-listing groups

Website API

On the website (POST /api/v1/listings/search), traffic context is auto-injected from the bev cookie. You don't need to pass partner_id or utm_source — the backend resolves it automatically.