Wyszukiwarka nieruchomości i agenci AI dla portali oraz PropTech
Integracja z API danych o nieruchomościach CASAFARI pozwala zespołom inżynieryjnym wdrożyć wyszukiwarkę oraz konwersacyjnych agentów AI w kilka dni, eliminując potrzebę budowania i utrzymywania własnych scraperów. Zamiast przetwarzać zduplikowane oferty z wielu portali, Państwa aplikacja uzyskuje dostęp do jednego zdeduplikowanego rekordu dla każdej nieruchomości wraz z pełną historią cen ofertowych i statusów w Polsce oraz na 15 innych rynkach.
Jak wdrożyć wyszukiwarkę nieruchomości bez budowy własnego potoku danych?
Tworzenie i utrzymanie własnej infrastruktury do zbierania danych z portali ogłoszeniowych wymaga ogromnych nakładów pracy inżynierskiej. W Polsce sytuację dodatkowo komplikuje wysoki udział umów otwartych – z analizy przeprowadzonej przez Dziennik Gazety Prawnej z czerwca 2026 r. wynika, że od 59% do 65% nowo dodawanych ogłoszeń na portalach to powielone oferty tego samego lokalu. Przetwarzanie surowych danych z serwisów takich jak Otodom, który według raportu UNIREPO z maja 2025 r. odpowiada za około 70% agencyjnych ofert sprzedaży mieszkań, a także OLX, Nieruchomosci-online.pl, Gratka czy Morizon, obciąża interfejs użytkownika szumem informacyjnym.
Wykorzystując usługę Property Sourcing poprzez REST API, Państwa system przesyła zapytania ustrukturyzowane lub w języku naturalnym i natychmiast otrzymuje spójne, zagregowane dane. Graf nieruchomości CASAFARI obejmuje Polskę oraz rynki zagraniczne, w tym Hiszpanię, gdzie według danych Colegio de Registradores de España z lipca 2026 r. polscy inwestorzy zakupili ponad 4 100 nieruchomości w 2025 roku. Pełną specyfikację techniczną zawiera dokumentacja wyszukiwarki nieruchomości przez API (w języku angielskim).
Jeżeli celem jest natychmiastowe wdrożenie gotowego komponentu interfejsu, wystarczy osadzić pole wyszukiwania Claro AI za pomocą publicznego klucza pub_. Zapewnia ono do 50 zdeduplikowanych wyników na stronę i pełną obsługę zapytań w języku naturalnym. Więcej szczegółów udostępnia instrukcja osadzania pola wyszukiwania Claro AI (w języku angielskim).
Jak połączyć link od klienta lub ID ogłoszenia z jedną nieruchomością i pełną historią cen?
Częstym wyzwaniem w aplikacjach CRM oraz portalach dla kupujących jest sytuacja, w której użytkownik wkleja link do ogłoszenia z zewnętrznego serwisu lub system importuje identyfikator oferty z pliku XML.
Dzięki punktowi końcowemu match-by-listings lub mechanizmowi rozwiązywania odnośników w usłudze Property Sourcing, Państwa aplikacja zamienia dowolny link bądź identyfikator z portalu na unikalny rekord nieruchomości w CASAFARI. Proces ten szczegółowo opisuje dopasowywanie ogłoszeń do jednej nieruchomości przez match-by-listings (w języku angielskim) oraz dokumentacja rozwiązywania linków przesłanych przez klientów w Property Sourcing (w języku angielskim).
Użytkownik zyskuje natychmiastowy podgląd wszystkich agencji i portali reklamujących ten sam obiekt, dokładne daty pojawienia się poszczególnych ofert oraz kompletną historię zmian cen ofertowych i statusów. Ułatwia to prowadzenie negocjacji i porządkuje lejki sprzedażowe, co pozwala również rozwijać rozwiązania takie jak CASAFARI CRM dla biur nieruchomości z wykorzystaniem integracji opisanej w dokumentacji CASAFARI Connect (w języku angielskim).
Jak osadzić agenta AI w rzeczywistych danych rynkowych zamiast w halucynacjach modelu?
Zespoły tworzące asystentów AI dla branży nieruchomości zmagają się z problemem halucynacji modeli LLM, które generują nieistniejące oferty lub nieaktualne ceny.
Rozwiązaniem jest podłączenie agenta bezpośrednio do architektury CASAFARI. Każdy produkt udostępnia standardową specyfikację OpenAPI (platform.casafari.com/v1/<product>/openapi.json), pliki tools.json oraz llms.txt. Dzięki temu integracja nie wymaga instalowania dedykowanych bibliotek SDK w npm czy PyPI, a obsługa błędów HTTP 402 (brak tokenów na koncie) oraz HTTP 429 (przekroczenie limitu zapytań) odbywa się w sposób przewidywalny. Zasady budowy takich narzędzi prezentuje poradnik na temat narzędzia danych o nieruchomościach dla asystenta AI (w języku angielskim).
W celu szybkiego uruchomienia przepływów pracy AI, warto wykorzystać dedykowane serwery Casafari MCP dla agentów AI, które pozwalają połączyć modele Claude, ChatGPT, Cursor czy Gemini CLI z aktualną bazą cen ofertowych.
Jak rozwiązywać lokalizacje i granice kodów pocztowych PNA w zapytaniach API?
W Polsce kody pocztowe PNA zarządzenie przez Poczta Polska S.A. są powiązane z rejonami doręczeń oraz identyfikatorami TERYT, a nie z oficjalnymi wielokątami administracyjnymi. Granice przestrzenne powstają na podstawie ponad 8,6 miliona punktów adresowych z Państwowego Rejestru Granic (GUGiK / Oficjalny Spis Pocztowych Numerów Adresowych (PNA) Poczty Polskiej).
Usługa Location Lookup automatycznie zamienia nazwy dzielnic (np. Mokotów, Wrzeszcz, Stare Podgórze) oraz kody pocztowe na kanoniczne identyfikatory lokalizacji CASAFARI. Zapewnia to precyzyjne filtrowanie przestrzenne przed skierowaniem zapytania do Property Sourcing.
Spójna struktura identyfikatorów geograficznych ułatwia przetwarzanie zapytań nie tylko w Polsce, lecz także w ujęciu międzynarodowym, wspierając projekty ukierunkowane na ekspansję biznesu z CASAFARI.
Jak uruchomić dostęp i przetestować API w swoim produkcie?
Proces wdrażania odbywa się w pełni samoobsługowo, bez konieczności prowadzenia rozmów sprzedażowych. Wystarczy zalogować się w konsoli CASAFARI i odebrać 1 000 darmowych tokenów, co pozwala na testowanie API przez 30 dni bez podawania karty płatniczej.
Po zakończeniu okresu próbnego możliwy jest wybór planu Agent w cenie 70 EUR miesięcznie (lub 49 EUR miesięcznie przy rozliczeniu rocznym) bądź wyższych pakietów dostosowanych do rosnącego zużycia. Pakiety Custom są szczegółowo opisane w dokumentacji platformy.
Swoje tokeny dostępu (access tokens) oraz konfigurację serwerów MCP można pobrać w kilka minut w portalu dla deweloperów.
Najczęściej zadawane pytania
Czy CASAFARI udostępnia bibliotekę SDK w npm lub PyPI do integracji API?
CASAFARI nie udostępnia i nie wymaga zewnętrznych bibliotek SDK w pakietach npm ani PyPI, eliminując ryzyko problemów z zależnościami. Każdy produkt oferuje czystą specyfikację OpenAPI (platform.casafari.com/v1/<product>/openapi.json), pliki tools.json oraz llms.txt. Do dyspozycji inżynierów są także dedykowane serwery MCP i wtyczki dla środowisk Claude Code, Cursor oraz Gemini CLI.
Skąd pochodzą ceny nieruchomości w CASAFARI i czy są to ceny transakcyjne?
Wszystkie wartości w grafie nieruchomości CASAFARI to ceny ofertowe agregowane i deduplikowane z publicznych portali ogłoszeniowych oraz stron biur nieruchomości wraz z pełną historią ich zmian. Dane te nie pochodzą z aktów notarialnych ani państwowych rejestrów transakcyjnych, takich jak polski Rejestr Cen Nieruchomości (RCN). Dzięki temu system odzwierciedla aktualną dynamikę rynku w czasie rzeczywistym.
Jak rozliczane są zapytania do Casafari API oraz serwerów Casafari MCP?
Rozliczanie zapytań do API oraz serwerów MCP opiera się na tokenach. Aby uniknąć pomyłek pojęciowych, uwierzytelnienie w systemie wykorzystuje tokeny dostępu (access tokens), podczas gdy stan konta wyrażony jest w tokenach użytkowych. Zespoły programistyczne mogą rozpocząć testy od darmowego pakietu 1 000 tokenów na 30 dni bez karty płatniczej, a obsługa kodów HTTP 402 (brak tokenów) i HTTP 429 (limit zapytań) jest w pełni zautomatyzowana.
Jakie rynki obejmuje graf nieruchomości CASAFARI dla polskich aplikacji PropTech?
Graf nieruchomości obejmuje 16 państw: Polskę, Hiszpanię, Portugalię, Francję, Niemcy, Włochy, Austrię, Belgię, Szwajcarię, Grecję, Luksemburg, Monako, Andorę, San Marino, Zjednoczone Emiraty Arabskie oraz Stany Zjednoczone, gdzie CASAFARI wchodzi obecnie na rynek amerykański w wybranych stanach, wyłącznie w segmencie nieruchomości komercyjnych, poprzez Claro AI. Taki zakres geograficzny pozwala polskim portalom i aplikacjom obsługiwać zarówno rynek krajowy, jak i transakcje polskich inwestorów kupujących nieruchomości w Hiszpanii.
Jak osadzić wyszukiwarkę Claro AI bezpośrednio we własnym serwisie lub CRM?
Zespoły inżynierskie mogą osadzić pole wyszukiwania Claro AI w interfejsie swojej aplikacji front-endowej za pomocą publicznego klucza pub_. Rozwiązanie to pozwala realizować zapytania w języku naturalnym i zwracać do 50 zdeduplikowanych wyników na stronę. Zapewnia to pełne bezpieczeństwo, ponieważ nie wymaga ujawniania prywatnych kluczy dostępowych do API po stronie klienta.
Sprawdź to na własnym rynku
1000 darmowych tokenów na 30 dni, bez karty. Potem plan Agent lub przedpłacone tokeny.