Te same publiczne informacje są dostępne dla człowieka i programu. Homevo nie nadaje ofertom pierwszeństwa tylko dlatego, że znajdują się na tej stronie.
Każda opublikowana oferta ma dokument /s/{kod}/facts oraz wersje facts.md i facts.json. Link przy fakcie prowadzi do jego stałej sekcji. Warianty wskazują oryginalną ofertę jako canonical; nagłówek HTTP Link pozwala odnaleźć pozostałe formaty.
Wartości to deklaracje publikującego, nie niezależny audyt Homevo. Hash wersji zmienia się wraz z publiczną projekcją danych: pozwala wykryć różnicę, ale nie potwierdza prawdziwości ani nie odtwarza historycznej wersji. ETag umożliwia odświeżenie tylko po zmianie.
Identyfikator dotyczy konkretnej publikacji. Transakcja SALE oznacza sprzedaż, RENT wynajem. Zbieżne zdjęcia, ulica czy metraż nie dowodzą, że ogłoszenie z innej strony jest tą samą nieruchomością. Homevo nie dopisuje takich powiązań automatycznie.
Dokładny adres pokazujemy wyłącznie, gdy publikujący zezwolił na jego ujawnienie. Dokument faktów nie wyciąga adresu, parametrów lub udogodnień z opisu marketingowego.
Publiczny endpoint porównania oblicza match, mismatch lub unknown dla każdego z podanych warunków. Brak danych nie oznacza spełnienia wymogu. Wynik zbiorczy: mismatch ma pierwszeństwo przed unknown, a match wymaga spełnienia wszystkich warunków. Nie jest to ranking atrakcyjności ani rekomendacja zakupu.
Domyślnie wymagamy aktualnej weryfikacji dostępności (verified_live=true). Materiał demonstracyjny nie spełnia tego wymogu. Parametr verified_live=false pomija wymóg dostępności do porównania samych parametrów, nie zmienia statusu demo. Wtedy wymagany jest co najmniej jeden inny warunek.
| Parametr | Znaczenie |
|---|---|
| transaction_type | SALE lub RENT |
| property_type | house lub apartment |
| city | Miasto, zgodność po normalizacji wielkości liter i odstępów |
| max_price_pln | Zapisana cena sprzedaży w PLN; najem lub inna waluta to unknown. Nie jest to całkowity koszt najmu ani suma opłat. |
| min_area_sqm / min_rooms | Minimalna powierzchnia / liczba pokoi |
| page / page_size | Strona i maksymalnie 100 rekordów; odpowiedź zawiera następny URL |
Oceniana jest strona publicznego katalogu w stabilnej kolejności identyfikatorów — także rekordy niespełniające warunków. Wynik strony nie oznacza przeszukania całej bazy; należy przejść wszystkie strony. Nie generujemy stron SEO dla kombinacji filtrów.
Weryfikacja dostępności nie jest audytem ceny, stanu prawnego, zdjęć ani pozostałych deklaracji. Zmiana rekordu nie odnawia automatycznie weryfikacji.