# Hotyata

> Real-time real estate & secondhand marketplace aggregator for Batumi and Tbilisi, Georgia. Aggregates classified listings from Telegram channels, groups, and real estate portals, deduplicates cross-posted listings, tracks residential complexes, and provides structured search.

## Real Estate Content
- [Batumi & Tbilisi Property Listings](https://hotyata.com/en/batumi/properties): Browse verified apartments for Sale, Long-term Rent, and Daily Rent (`/:locale/:city/properties`).
- [Top Daily Real Estate Deals](https://hotyata.com/en/batumi/deals): Algorithmically ranked top 5 properties per day across sales and rental tiers (`/:locale/:city/deals`).
- [Residential Complexes Catalog](https://hotyata.com/en/batumi/complexes): New development projects, developer specs, floor plans, and delivery status (`/:locale/:city/complexes`).

## Classifieds Content
- [Secondhand Marketplace Listings](https://hotyata.com/en/batumi/items): Deduplicated Telegram classifieds in Batumi and Tbilisi (`/:locale/:city/items`).

## Public REST & Markdown API for AI Agents & LLMs
- [Properties Search API (JSON)](https://hotyata.com/api/v1/properties.json): Search verified real estate listings with rich filters.
- [Properties Search API (Markdown)](https://hotyata.com/api/v1/properties.md): LLM-optimized Markdown output for property searches.
- [Classified Items Search API (JSON)](https://hotyata.com/api/v1/items.json): Hybrid full-text and vector search for secondhand marketplace items.
- [Classified Items Search API (Markdown)](https://hotyata.com/api/v1/items.md): LLM-optimized Markdown output for marketplace item searches.
- [OpenAPI 3.0.3 Specification](https://hotyata.com/openapi.json): Complete machine-readable schema for all REST endpoints and parameters.
- [Agentic Resource Discovery (ARD) Manifest](https://hotyata.com/.well-known/ard.json): Federated AI capability manifest (`/.well-known/ard.json` and `/.well-known/ai-catalog.json`).

## Model Context Protocol (MCP) for AI Agents
- [MCP Streamable HTTP Endpoint](https://hotyata.com/mcp): Official Model Context Protocol endpoint supporting Streamable HTTP (`POST /mcp`).
- [MCP SSE Endpoint](https://hotyata.com/mcp/sse): Server-Sent Events transport (`GET /mcp/sse`) exposing `search_real_estate`, `get_real_estate_stats`, `get_property_details`, `search_complexes`, `get_complex_details`, `search_classified_items`, `get_item_details`, and `report_issue`.
- [XML Sitemap](https://hotyata.com/sitemap.xml): Full index of localized pages across English, Russian, and Georgian.

## Optional
- [Pet-friendly rentals under $600 with no summer hike](https://hotyata.com/api/v1/properties.md?city=batumi&deal_type=rent_long&pets_allowed=true&no_summer_increase=true&max_price=600): Example Markdown API query for long-term Batumi rentals.
- [Renovated seaside apartments for sale with gas](https://hotyata.com/api/v1/properties.md?city=batumi&deal_type=sale&renovation_status=renovated&has_gas=true&max_distance_to_sea=300&sea_view=any&sort=cheapest_sqm): Example Markdown API query for Batumi apartment sales.
- [Direct owner 2-bedroom rentals in Old Batumi](https://hotyata.com/api/v1/properties.md?city=batumi&deal_type=rent_long&district=Old+Batumi&rooms=2&seller_type=owner&min_floor=4): Example Markdown API query filtered by seller type and district.