MVP hotel discovery layer

Search first on ZEV City.

This MVP keeps hotel discovery inside ZEV City, shows an indicative clean-energy allocation estimate, then hands the traveler to a partner checkout with tracking.

Prices are discovered from hotel search data providers and may change at partner checkout. ZEV rewards are estimates until a confirmed booking, commission event, and clean-energy allocation receipt exist.

Provider: auto Allocation model: 5% indicative Checkout: partner handoff

Run a search to see hotel discovery results. If no provider key is configured yet, the API returns a clearly marked sample result set so the product flow can be tested end to end.

{
  "zev_city_hotel_search_mvp": {
    "status": "discovery_layer_mvp",
    "live_booking": false,
    "price_guarantee": false,
    "reward_guarantee": false,
    "user_flow": "search_on_zev_city -> inspect estimated energy allocation -> continue_to_partner_checkout -> match conversion later",
    "provider_priority": ["serpapi_if_key_configured", "mock_fallback_now", "dataforseo_next", "apify_or_oxylabs_optional"],
    "claim_boundary": "Prices and ZEV allocations are indicative until partner checkout and booking confirmation."
  }
}