Kompare travel search

The quickest way to search: describe the trip in plain words and get bookable trips back in one call.

travelType, one of:

• ski: ski and snowboard holidays

• golf: golf holidays

• surf: surf camps and holidays

• diving: diving holidays

• hiking: hiking and walking holidays

• charter: package holidays: sun and beach trips with flight and hotel

• cycling: cycling holidays

• football: football trips: a match ticket with travel and hotel

• carrental: car rental

• f1: Formula 1 race trips

• running: running races abroad, marathons and the like

• americanfootball: NFL game trips

• yoga: yoga retreats

• triathlon: triathlon races and training camps

• cruise: cruises

• coach: coach (bus) tours

• holidayhome: holiday homes and cottages

• roundtrip: round trips and guided tours through several places

• citybreak: city breaks

• dance: dance holidays

places: destinations, ski areas, regions or countries in plain words, English or Danish ("Ischgl", "Østrig", "Costa del Sol"). Leave it out for anywhere. When: startFrom/startTo (the window the trip starts in) or months. Party: adults and children, since prices depend on them. Optional: durationDays, maxPricePerPerson, sort (best, cheapest, soonest), limit.

Response: { understood, ...{ total, accommodationCount, offset, results: [{ name, country, destination, stars, guestRating, tripsAvailable, trips: [{ start, end, durationDays, adults, children, price, pricePerPerson, currency, priceBeforeDiscount, transport, meals, unit, seller, bookingUrl }] }] } }

• understood says how the request was read: the places searched, placesNotFound and placesAmbiguous. When a place was not found or is ambiguous, tell the user instead of presenting other trips as theirs.

• price is the whole party's price; pricePerPerson divides it. Quote them as given, in currency — never convert or round them into a different claim.

• trips holds the first few dates in sort order; tripsAvailable says how many more exist. Page with offset (it counts accommodations).

• seller is the travel agency that sells the trip. bookingUrl opens that trip on the seller's site — give it to the user as the way to book. It is null when the seller can only be compared, not booked, through Kompare.

• start/end are the trip's own first and last day. When nothing matches, the response holds alternatives (counts with one filter removed) to suggest what to relax. When no place matched at all, it holds a message and nothing was searched.

For a filter this tool lacks (meal plan, stars, transport, ski pass, distance to the lift, ...) use search_listings.

Get facet counts for filterable fields, respecting current filters.

CRITICAL: You MUST include ALL established filters in every call — especially niche, market, adults, children, and arrivalWeeks/arrivalMonths. The facetFields parameter only controls which breakdowns are returned, NOT which filters are applied. If you omit a filter like arrivalWeeks, the counts will include ALL dates — giving misleading numbers that won't match actual availability for the user's requested dates.

Example — WRONG: User wants ski in France next week for 2 people. You call get_facets with niche="ski", market="dk", countries=["france"], facetFields=["destinationSlug"]. This returns counts across ALL dates — showing destinations that may have 0 results for next week.

Example — RIGHT: Same scenario. You call get_facets with niche="ski", market="dk", countries=["france"], arrivalWeeks=["2026-W15"], adults=2, children=0, facetFields=["destinationSlug"]. This returns only destinations with actual availability for next week with 2 adults.

Returns: { totalCount, facets: { fieldName: { value: count, ... }, ... }, hierarchical } hierarchical lists field pairs (e.g. country ↔ destination) whose bucket counts are not expected to sum to totalCount.

Common use cases:

• Check destination availability: facetFields=["countrySlug", "destinationSlug"] — include arrivalWeeks + adults + children

• Check date availability: facetFields=["arrivalYearWeek", "arrivalYearMonth"] — include destination/country + adults + children

• Explore filter options: facetFields=["durationDays", "provider"] — include ALL current filters

• Answer "where else can I go?": facetFields=["countrySlug", "destinationSlug"] — include ALL current filters (dates, travelers)

Facetable fields — common (every niche): countrySlug, destinationSlug, provider, centrumDistanceRange, priceRange, pricePerPersonRange, durationDays, arrivalYearWeek, arrivalYearMonth, arrivalDate, stars, guestRatingBucket, transport, accommodationType, mealPlanType, accommodationFeatures. Niche-scoped (only meaningful on that niche): ski — skiPassIncluded, skiLiftDistanceRange, skiBusDistanceRange, skiSlopeDistanceRange, guideIncluded, transferIncluded; golf — greenFeeIncluded, courseDistanceRange, golfRoundsRange, golfTripType, golfBagIncluded, guideIncluded, transferIncluded; surf — surfSchoolIncluded, beachDistanceRange, waveType; diving — diveCenter; hiking — difficultyLevel, dailyDistanceRange, trailheadDistanceRange, tripFormat, routeDistanceRange, elevationGainRange, luggageTransportIncluded, guideIncluded, gpxAvailable; charter — beachDistanceRange, guideIncluded, transferIncluded; cycling — difficultyLevel, cyclingType, tripFormat, routeDistanceRange, elevationGainRange, eBikeAvailable, luggageTransportIncluded, guideIncluded, bikeRentalAvailable, gpxAvailable; football — league, homeTeam, awayTeam, team, matchDate, hotelIncluded; carrental — carSupplier, carClass, carBodyType, transmission, fuelType, seats, zeroExcess, pickupStation, pickupStationType; f1 — guideIncluded, hotelIncluded, race, season, raceDate, ticketType, raceDays, transferIncluded; running — guideIncluded, hotelIncluded, race, season, raceDate, transferIncluded, distances, terrain, raceSeries, entryIncluded; americanfootball — guideIncluded, league, homeTeam, awayTeam, team, matchDate, hotelIncluded, season, transferIncluded, gameType; yoga — transferIncluded, retreatFocus, yogaLevel, yogaStyles, meditationIncluded, vegetarianMeals, danishInstructor; triathlon — guideIncluded, hotelIncluded, race, season, raceDate, transferIncluded, entryIncluded, tripType, triathlonDistance, raceBrand, bikeTransportIncluded; cruise — guideIncluded, cruiseType, cruiseLine, cabinType, cruiseRegion, embarkationCountry, flightIncluded, drinksIncluded, excursionsIncluded; coach — guideIncluded, excursionsIncluded, coachTripType, pickupRegion; holidayhome — beachDistanceRange, maxPersons, bedrooms, houseSizeRange, petsAllowed, consumptionIncluded, freeCancellation; roundtrip — excursionsIncluded, tourFormat, danishGuide, guaranteedDeparture; citybreak — transferIncluded, excursionsIncluded, escorted; dance — transferIncluded, danceStyles, danceLevel, soloWelcome.

Always pass facetFields to limit which facets are returned (improves performance). Filtered facets exclude their own filter to keep all options visible.

Get a comprehensive overview of the available travel data for ONE niche before searching. Call this FIRST.

Required parameters (all four):

• niche: ONE travel type — "ski", "golf", "surf", "diving", "hiking", "charter", "cycling", "football", "carrental", "f1", "running", "americanfootball", "yoga", "triathlon", "cruise", "coach", "holidayhome", "roundtrip", "citybreak", "dance". Single niche per call; to compare niches, call once per niche.

• market: market code (one of "dk")

• adults: number of adult travelers (1-20)

• children: number of children (0-20)

Occupancy is required because counts and prices depend on group size — the overview is scoped to this exact cohort.

Returns:

• totalCount: total listings for this niche and group size

• priceRange: { min, max } total price range

• pricePerPersonRange: { min, max } per-person price range

• averages: { price, pricePerPerson, stars, durationDays } — useful for setting expectations

• dateRange: { earliest, latest } departure date range

• destinationCount: total unique destinations available

• availability.byMonth: array of { period: "2026-04", count, minPrice } — listings per month with cheapest price. Use this to suggest optimal travel months.

• ratingDistribution: star-bracket counts

• topDestinations: array of { destinationSlug, countrySlug, count, minPrice } — top 15 destinations sorted by popularity

• facets: unfiltered facet counts for the main filterable fields (countries, providers, durations, etc.)

Use availability.byMonth to guide users toward dates with the most options and best prices. Use topDestinations to suggest popular destinations. Use averages to set price expectations.

Search for travel listings with filters, sorting, and pagination.

This is the main search tool. Use it after search_init to find specific travel deals.

Required parameters:

• niche: ONE travel type — "ski", "golf", "surf", "diving", "hiking", "charter", "cycling", "football", "carrental", "f1", "running", "americanfootball", "yoga", "triathlon", "cruise", "coach", "holidayhome", "roundtrip", "citybreak", "dance". Single niche per request.

• market: market code (one of "dk")

Common filters (valid for every niche):

• adults (ALWAYS include — prices depend on group size)

• children (ALWAYS include — prices depend on group size)

• departureFrom (YYYY-MM-DD)

• departureTo (YYYY-MM-DD)

• onlyDiscounted (boolean — only trips with a discount)

• onlyMultiDestination (boolean — only trips that sleep in more than one place (round trips, stage tours))

• countries (array of country slugs — use EXACT slugs, e.g. ["austria"])

• destinations (array of destination slugs in country_destination format, e.g. ["austria_zell-am-see"] — use EXACT slugs. Also returns round trips and stage tours that stop there; their accommodation.route lists every stop)

• providers (array of provider slugs)

• centrumDistance ({ min, max } meters to town centre)

• minPrice (total price, not per person)

• maxPrice (total price, not per person)

• minPricePerPerson (per-person price)

• maxPricePerPerson (per-person price)

• durations (array of trip lengths in days, e.g. [7, 14])

• arrivalWeeks (array of ISO weeks, e.g. ["2026-W15"] — use for "next week")

• arrivalMonths (array of months, e.g. ["2026-04"] — use for "in April")

• arrivalDates (array of exact arrival dates, YYYY-MM-DD)

• departureDateFlexDays (0-7, day flex around arrivalDates)

• minStars (minimum hotel star rating, 1-5)

• minGuestRating (guest review score 0-10 (TripAdvisor scores are ×2 normalized))

• maxGuestRating (guest review score 0-10)

• includeUnratedGuestRating (boolean — keep unrated hotels in rated searches)

• transports (array: bus, train, car, flight_bll, flight_cph, flight_aal, flight_arn, flight_got, flight_ham, flight_aar, flight_krp, flight_rnn)

• accommodationTypes (array: hotel, apartment, cabin, chalet, villa, hostel, resort, pension, house, other)

• mealPlanTypes (array: all_inclusive, breakfast, full_board, half_board, none)

• accommodationFeatures (array, e.g. pool, wifi, sauna, spa, parking, bar)

Niche-specific filters (only valid when niche matches):

• Ski: skiPassIncluded (boolean), skiPassDaysCount ({ min, max } bundled lift-pass days), skiLiftDistance ({ min, max } meters), skiBusDistance ({ min, max } meters), skiSlopeDistance ({ min, max } meters), guideIncluded (boolean), transferIncluded (boolean — the transfer from the airport/station (or circuit) to the accommodation is bundled)

• Golf (accommodation-centric like ski; greenFeeIncluded says whether ANY golf is in the price, golfRoundsRanges/golfBagIncluded refine it further; guideIncluded is a golf host, not a generic tour guide): greenFeeIncluded (boolean — the package price includes green fees (any rounds or unlimited golf); false = golf is bought separately), courseDistance ({ min, max } meters, hotel to nearest course), golfRoundsRanges (array: none, 1-3, 4-5, 6+, unlimited — rounds included per golfer ('none' = green fee not included)), golfTripTypes (array: stay, school, group, longstay, tour — 'stay' is the default golf-hotel package), golfBagIncluded (boolean — golf bag carried on the flight at no extra charge), guideIncluded (boolean), transferIncluded (boolean — the transfer from the airport/station (or circuit) to the accommodation is bundled)

• Surf: surfSchoolIncluded (boolean), beachDistance ({ min, max } meters), waveTypes (array)

• Diving: diveCenter (boolean)

• Hiking: difficultyLevels (array), dailyDistance, trailheadDistance ({ min, max } meters), hikingTripFormats, routeDistance ({ min, max } km), elevationGain ({ min, max } meters), luggageTransportIncluded (boolean), guideIncluded (boolean), gpxAvailable (boolean)

• Charter: beachDistance ({ min, max } meters), guideIncluded (boolean), transferIncluded (boolean — the transfer from the airport/station (or circuit) to the accommodation is bundled)

• Cycling: cyclingDifficultyLevels (array: easy, moderate, challenging, hard, expert), cyclingTypes (array: road, gravel, mountainbike, e_mountainbike, e_bike, bike_cruise, event), tripFormats (array: self_guided, guided_group, private_custom, club_event, race_event), routeDistance ({ min, max } km), elevationGain ({ min, max } meters), eBikeAvailable (boolean), luggageTransportIncluded (boolean), guideIncluded (boolean), bikeRentalAvailable (boolean), gpxAvailable (boolean)

• Football (match-centric; the match ticket is always included, transport fly/kør-selv via the shared transports filter): leagues (array of league slugs, e.g. ["premier-league", "la-liga"] or ["nfl"] — use EXACT slugs from the league facet), teams (array of team slugs, e.g. ["wolverhampton-wanderers"] or ["kansas-city-chiefs"] — use EXACT slugs from the team facet; matches the home OR away side), matchDateFrom (YYYY-MM-DD, kickoff date), matchDateTo (YYYY-MM-DD, kickoff date), hotelIncluded (boolean)

• Carrental (groups by car group at a pickup station; adults/children do not price a car — they only set minSeats; prices are per rental, not per person): carSuppliers (array of rental-brand slugs, e.g. ["avis"] — use EXACT slugs from the carSupplier facet), carClasses (array: mini, economy, compact, intermediate, standard, fullsize, premium, luxury, special), carBodyTypes (array: car, suv, estate, van, convertible, other), transmissions (array: manual, automatic), fuelTypes (array: petrol, diesel, hybrid, electric), minSeats (integer 1-20, minimum seats — set it from the party size), zeroExcess (boolean — only rate tiers without an excess (ingen selvrisiko)), pickupStations (array of pickup-station slugs, e.g. ["london-heathrow-t5"] — use EXACT slugs from the pickupStation facet), pickupStationTypes (array: airport, city, rail, port, other)

• F1 (event-centric (one card = one Grand Prix weekend); the race ticket is always included, hotel via hotelIncluded, transport fly/kør-selv via the shared transports filter; guideIncluded = a tour leader travels with the group): guideIncluded (boolean), hotelIncluded (boolean), races (array of race slugs, e.g. ["monaco"] (f1), ["berlin-marathon"] (running) or ["ironman-kalmar"] (triathlon) — use EXACT slugs from the race facet), seasons (array of season years, e.g. [2026]), raceDateFrom (YYYY-MM-DD, race day (not the travel dates); a triathlon camp: its departure date), raceDateTo (YYYY-MM-DD, race day (not the travel dates); a triathlon camp: its departure date), ticketTypes (array: grandstand, general_admission, hospitality), raceDays (array: 3_day, 2_day, 1_day (Fri–Sun / Sat–Sun / race day only)), transferIncluded (boolean — the transfer from the airport/station (or circuit) to the accommodation is bundled)

• Running (event-centric (one card = one race edition); the race entry is NOT always included (entryIncluded), arrival/departure are the travel window around the race day, hotel via hotelIncluded): guideIncluded (boolean), hotelIncluded (boolean), races (array of race slugs, e.g. ["monaco"] (f1), ["berlin-marathon"] (running) or ["ironman-kalmar"] (triathlon) — use EXACT slugs from the race facet), seasons (array of season years, e.g. [2026]), raceDateFrom (YYYY-MM-DD, race day (not the travel dates); a triathlon camp: its departure date), raceDateTo (YYYY-MM-DD, race day (not the travel dates); a triathlon camp: its departure date), transferIncluded (boolean — the transfer from the airport/station (or circuit) to the accommodation is bundled), distances (array: 5k, 10k, half_marathon, marathon, ultra, other — matches a package offering ANY of them), terrains (array: road, trail), raceSeries (array: majors, superhalfs — World Marathon Majors / SuperHalfs), entryIncluded (boolean — the race entry (bib / startnummer) is bundled; false = not bundled (it may be a paid add-on or not offered at all — never promise the traveller can buy one))

• Americanfootball (event-centric (one card = one NFL game, mostly the International Series in London/Paris/Madrid/Munich plus the Super Bowl); the game ticket is always included, hotel via hotelIncluded; a Super Bowl sold before the bracket has no teams — use gameTypes ["super_bowl"], not teams): guideIncluded (boolean), leagues (array of league slugs, e.g. ["premier-league", "la-liga"] or ["nfl"] — use EXACT slugs from the league facet), teams (array of team slugs, e.g. ["wolverhampton-wanderers"] or ["kansas-city-chiefs"] — use EXACT slugs from the team facet; matches the home OR away side), matchDateFrom (YYYY-MM-DD, kickoff date), matchDateTo (YYYY-MM-DD, kickoff date), hotelIncluded (boolean), seasons (array of season years, e.g. [2026]), transferIncluded (boolean — the transfer from the airport/station (or circuit) to the accommodation is bundled), gameTypes (array: preseason, regular_season, playoffs, super_bowl (International Series games abroad are regular_season))

• Yoga (destination-centric (one card = one retreat venue); yogaStyles is OR-matched, and unknown booleans are unset, never false): transferIncluded (boolean — the transfer from the airport/station (or circuit) to the accommodation is bundled), yogaRetreatFocuses (array: yoga, yoga_hiking, yoga_surf, yoga_wellness, yoga_active, yoga_culture, teacher_training — what the retreat pairs yoga with; teacher_training = a 200h/500h course), yogaLevels (array: beginner, all_levels, intermediate, advanced), yogaStyles (array: hatha, vinyasa, yin, ashtanga, kundalini, iyengar, restorative, yoga_nidra, power, aerial, somatic, other — matches a retreat teaching ANY of them), meditationIncluded (boolean — meditation or mindfulness is part of the programme), vegetarianMeals (boolean — the kitchen is vegetarian (not just a vegetarian option on request)), danishInstructor (boolean — the yoga teacher teaches in Danish)

• Triathlon (event-centric: one card = one race edition (tripTypes race) or one training camp (tripTypes camp, its departures are the offers); the race entry is usually NOT included (entryIncluded); raceDate* = race day for races, departure date for camps): guideIncluded (boolean), hotelIncluded (boolean), races (array of race slugs, e.g. ["monaco"] (f1), ["berlin-marathon"] (running) or ["ironman-kalmar"] (triathlon) — use EXACT slugs from the race facet), seasons (array of season years, e.g. [2026]), raceDateFrom (YYYY-MM-DD, race day (not the travel dates); a triathlon camp: its departure date), raceDateTo (YYYY-MM-DD, race day (not the travel dates); a triathlon camp: its departure date), transferIncluded (boolean — the transfer from the airport/station (or circuit) to the accommodation is bundled), entryIncluded (boolean — the race entry (bib / startnummer) is bundled; false = not bundled (it may be a paid add-on or not offered at all — never promise the traveller can buy one)), tripTypes (array: race, camp — race = a package to a named race, camp = a dated training camp), triathlonDistances (array: full, half, olympic, sprint, other — full = IRONMAN, half = 70.3, olympic = 5150; matches ANY of them), raceBrands (array: ironman, challenge, other), bikeTransportIncluded (boolean — the athlete’s own bike flies with the package; false = an add-on or not offered)

• Cruise (one card = one sailing (ship + embarkation port + length); cruiseLines is the ship operator, never the reselling agency; flightIncluded/drinksIncluded/excursionsIncluded/guideIncluded are all null when the line does not say): guideIncluded (boolean), cruiseTypes (array: ocean, river, coastal, expedition), cruiseLines (array: msc, costa, royal_caribbean, celebrity, norwegian, princess, holland_america, carnival, cunard, p_and_o, disney, virgin_voyages, oceania, regent, azamara, silversea, seabourn, explora, windstar, ponant, viking, hurtigruten, havila, ambassador, fred_olsen, aida, tui_cruises, amawaterways, nicko, a_rosa, avalon, uniworld, scenic, other — the ship operator, not the reselling agency), cabinTypes (array: inside, oceanview, balcony, suite — cheapest bookable category the offer prices), cruiseRegions (array: mediterranean, norwegian_fjords, northern_europe, baltic, british_isles, atlantic_islands, arctic, antarctica, caribbean, north_america, alaska, south_america, asia, middle_east, africa, oceania, transatlantic, world, rhine, danube, douro, seine, rhone, elbe, nile, mekong, other_river), embarkationCountries (array of country slugs the ship departs from), flightIncluded (boolean — flight to/from the embarkation port is bundled), drinksIncluded (boolean — an onboard drinks package is bundled), excursionsIncluded (boolean — excursions are bundled (shore excursions on a cruise, sightseeing on a coach tour or city break))

• Coach (destination-centric like cycling (one card = one seller's tour, departures are the offers); pickupRegions matches a tour boarding in ANY chosen Danish region; guideIncluded/excursionsIncluded are shared with cruise and null when the operator does not say): guideIncluded (boolean), excursionsIncluded (boolean — excursions are bundled (shore excursions on a cruise, sightseeing on a coach tour or city break)), coachTripTypes (array: round_trip, city_break, christmas_market, holiday_stay, garden, event, wellness, other), pickupRegions (array: north_jutland, central_jutland, south_jutland, funen, zealand, copenhagen, bornholm — the Danish region the coach boards in, matches ANY chosen region)

• Holidayhome (one card = one specific rentable house; price is per HOUSE for the stay, never per person — adults/children only set a capacity floor (maxPersons >= adults + children), same mechanism as carrental minSeats; beachDistance is shared with surf/charter; maxPersons is that ROW's price-band top (a house priced by party size emits one row per band, e.g. a "2-person offer"), never the house's real capacity — when telling the visitor what a house sleeps, use houseCapacity, and never phrase a result as "max N persons"): beachDistance ({ min, max } meters), minBedrooms (minimum bedrooms), houseSizeRanges (array: 0-60, 60-80, 80-100, 100-130, 130-170, 170-250, 250+ — living area in m², matches ANY of them), petsAllowed (boolean — pets are allowed in the house), consumptionIncluded (boolean — electricity, water and heating are included in the price), freeCancellation (boolean — only prices that can be cancelled free of charge (refundable rate); without it a house shows its cheapest rate, often non-refundable)

• Roundtrip (coach's shape (one card = one seller's multi-stop tour, departures are the offers); the overnight places are route stops, so a town search finds every tour sleeping there; price is the party total (per person in a shared double for even parties, single supplement included for one traveller or an odd party); danishGuide/guaranteedDeparture/excursionsIncluded are null when the seller does not say): excursionsIncluded (boolean — excursions are bundled (shore excursions on a cruise, sightseeing on a coach tour or city break)), tourFormats (array: guided_group, small_group, self_drive, private — self_drive is a fly & drive round trip in a rental car with a fixed day plan, not a car-rental search), danishGuide (boolean — a Danish-speaking tour guide is stated; null when the seller does not say), guaranteedDeparture (boolean — the departure is guaranteed to run; null when the seller does not say, never read as "not guaranteed")

• Citybreak (charter-shaped: one card = one city hotel, each offer a date x stay length x departure airport x party; the price is the party total for the stay as the seller quotes it; escorted = a fixed-date trip with a tour leader (a plain city-break search is a free flight+hotel stay, so set escorted only when the visitor wants a leader); centrumDistance is the key city-break quality signal; transferIncluded/excursionsIncluded are null when the seller does not say): transferIncluded (boolean — the transfer from the airport/station (or circuit) to the accommodation is bundled), excursionsIncluded (boolean — excursions are bundled (shore excursions on a cruise, sightseeing on a coach tour or city break)), escorted (boolean — a fixed-date trip with a tour leader and a programme; absent = everything, including free flight+hotel stays)

• Dance (destination-centric like yoga (one card = one dance week at one venue); danceStyles is OR-matched, and unknown booleans are unset, never false): transferIncluded (boolean — the transfer from the airport/station (or circuit) to the accommodation is bundled), danceStyles (array: ballroom, latin, tango, swing, linedance, flamenco, dance_fitness, other — matches a dance week teaching ANY of them), danceLevels (array: beginner, all_levels, intermediate, advanced), soloWelcome (boolean — true = the page says you can come without a dance partner; false = a partner is needed (pardans); most weeks leave it unset, so for a solo traveller prefer danceStyles linedance or dance_fitness over this filter)

Distance filters are { min, max } objects (both bounds optional), e.g. { "max": 500 } for "within 500 m".

Sorting & pagination:

• sort: one of "price", "pricePerPerson", "departureDate", "stars", "kompareScore" (Kompare’s ranking weighs the price against similar trips, hotel stars, guest ratings, how well the trip fits the party and the commission the travel agency pays Kompare. Agencies with a commission agreement always rank above those without.), "discountPercentage", "distanceToCentrum", "distanceToLift" (ski ONLY — silently sorts by price on every other niche, so never offer it there), "providerMix"

• order: "asc" or "desc"

• limit: results per page (1-100)

• offset: pagination offset

IMPORTANT: countries and destinations use EXACT slug matching — always use the exact slugs returned by search_init (topDestinations) or get_facets (countrySlug/destinationSlug facets). Do NOT guess slugs.

Response — the matching accommodations with their trips: { total, accommodationCount, offset, results: [{ name, country, destination, stars, guestRating, tripsAvailable, trips: [{ start, end, durationDays, adults, children, price, pricePerPerson, currency, priceBeforeDiscount, transport, meals, unit, seller, bookingUrl }] }] }

• price is the whole party's price; pricePerPerson divides it. Quote them as given, in currency — never convert or round them into a different claim.

• trips holds the first few dates in sort order; tripsAvailable says how many more exist. Page with offset (it counts accommodations).

• seller is the travel agency that sells the trip. bookingUrl opens that trip on the seller's site — give it to the user as the way to book. It is null when the seller can only be compared, not booked, through Kompare.

• start/end are the trip's own first and last day.

• Pass limit (5-10 is plenty) to keep the reply short. If the filters match nothing, the response instead contains alternatives (facet counts with one filter removed) — use them to suggest what the user could relax.

Tips:

• ALWAYS pass ALL established filters (adults, children, arrivalWeeks/arrivalMonths, niche, market, countries, destinations, etc.) — never drop previously established filters

• Prices depend on group size — always include adults and children

• Start with broad searches, then narrow down with filters

• Use sort=pricePerPerson&order=asc to find cheapest deals

• Use sort=kompareScore&order=desc for Kompare's ranking (see sort above)

• Use sort=providerMix&order=desc for fair provider diversity (round-robin interleave)

• Check search_init first to know valid filter values (topDestinations has exact country/destination slugs)

• Call get_facets before search_listings to verify results exist — use the EXACT SAME filters