Platform

Casafari ist die KI-Agent-native Plattform für Immobiliendatenintelligenz. Der umfassendste Immobilienindex Europas: ein bereinigter, deduplizierter Immobiliengraph für Wohn- und Gewerbeimmobilien, zum Kauf und zur Miete, in 16 Ländern.Der umfassendste Immobilienindex Europas: ein bereinigter, deduplizierter Immobiliengraph.

Wie der Graph aufgebaut ist

Existing Casafari API · API v1 · Properties

Get property by ID

GEThttps://api.casafari.com/v1/properties/search/{property_id}
Statisches Token3 ParameterAPI v1

Senden Sie Authorization: Token $CASAFARI_TOKEN mit Ihrem bestehenden API-Token; siehe wo Sie diesen erhalten.

The same path under /api, signed in with a bearer token, is in the REST API reference: GET /api/v1/properties/search/{property_id}.

Description

Returns a property object.

Pfadparameter

property_idZeichenfolgeerforderlich

Abfrageparameter

limitinteger
Anzahl der Ergebnisse, die pro Seite zurückgegeben werden sollen.
offsetinteger
Offset from which to start the search. Maximum value is 50000.

Beispielanfrage

Nur Platzhalter: Ersetzen Sie das Token und die Werte durch Ihre eigenen.

curl
curl "https://api.casafari.com/v1/properties/search/<property_id>" \
  -H "Authorization: Token $CASAFARI_TOKEN"

Antworten

200

Typ: object[].

Show the response shape (177 fields)
countinteger
nextZeichenkette (URI)kann null sein
previousZeichenkette (URI)kann null sein
resultsobject
64 properties
property_idintegererforderlich
ID der Immobilie.
primary_listing_idintegererforderlich
Primäre Inserats-ID der Immobilie, die nach der Zusammenführung zum Immobiliengraphen definiert wird.
typeZeichenfolgeerforderlich
Property type, as returned by the GET /v1/references/types endpoint.
40 zulässige Werteapartment studio duplex penthouse dachgeschosswohnung etagenwohnung erdgeschosswohnung country_house house palace townhouse villa country_estate chalet bungalow family_house reihenhaus reihenendhaus reihenmittelhaus einfamilienhaus zweifamilienhaus landwirtschaftliche_betriebe retail office industrial warehouse hotel other_commercial restaurant werkstatt plot urban_plot rural_plot room other garage parking apartment_building office_building mix_use_building
type_groupZeichenfolgeerforderlich
Property type group, as returned by the GET /v1/references/types endpoint.
operationsstring[]erforderlich
Verfügbare Nutzungsarten der Immobilie.
sale rent
locationobjecterforderlich
Informationen zum Objektstandort.
4 Immobilien
location_idintegererforderlich
Standort-ID, wie sie vom Endpunkt POST /v1/references/locations zurückgegeben wird.
nameZeichenfolgeerforderlich
Standortname.
administrative_levelZeichenfolgeerforderlich
Verwaltungsebene des Standorts.
zip_codesstring[]
Die Postleitzahlen des Standorts.
Standard []
locations_structureobject[]erforderlich
Informationen zu allen übergeordneten Standorten (einschließlich des Objektstandorts) bis hin zum Land.
4 Immobilien
location_idintegererforderlich
Standort-ID, wie sie vom Endpunkt POST /v1/references/locations zurückgegeben wird.
nameZeichenfolgeerforderlich
Standortname.
administrative_levelZeichenfolgeerforderlich
Verwaltungsebene des Standorts.
zip_codesstring[]
Die Postleitzahlen des Standorts.
Standard []
coordinatesobjecterforderlich
Objektkoordinaten.
2 Eigenschaften
latitudenumbererforderlich
Latitude.
longitudenumbererforderlich
Longitude.
total_areaintegererforderlich
Gesamtfläche.
living_areaintegererforderlich
Wohnfläche.
plot_areaintegererforderlich
Grundstücksfläche.
terrace_areaintegererforderlich
Terrassenfläche.
bathroomsintegererforderlich
Anzahl der Badezimmer.
bedroomsintegererforderlich
Anzahl der Schlafzimmer.
roomsintegererforderlich
Anzahl der Zimmer.
number_of_parkingsintegerkann null sein
Anzahl der Stellplätze.
floor_numberintegererforderlich
Genaue Etagenangabe. Negative Werte stehen für Untergeschosse (z. B. Keller).
rent_currencyZeichenfolgeerforderlich
Währungscode des Mietpreises.
rent_periodZeichenfolgeerforderlich
Mietzeitraum.
day week fortnight month year none
rent_priceintegererforderlich
Aktueller Mietpreis in der Währung der Inserate (angegeben durch das Feld rent_currency).
rent_statusZeichenfolgeerforderlich
Aktueller Vermietungsstatus der Immobilie.
active reserved hold rented none
sale_currencyZeichenfolgeerforderlich
Währungscode des Verkaufspreises.
sale_priceintegererforderlich
Aktueller Verkaufspreis in der Währung der Inserate (angegeben durch das Feld sale_currency).
sale_statusZeichenfolgeerforderlich
Aktueller Verkaufsstatus der Immobilie.
active reserved hold sold none
is_private_propertybooleanerforderlich
Angabe, ob das Objekt von einer Privatperson inseriert wurde, im Gegensatz zu einem Makler oder einem gewerblichen Anbieter.
featuresobjecterforderlich
Ausstattungsmerkmale, wie vom Endpunkt GET /v1/references/features zurückgegeben.
7 Immobilien
floorZeichenfolgeerforderlich
Etagenart.
no_floor ground middle top
orientationZeichenfolgeerforderlich
Ausrichtung des Ausblicks der Immobilie.
exterior interior
viewZeichenfolgeerforderlich
Ausblick der Immobilie. Dieses Feld ist veraltet und wird mit dem nächsten größeren Update entfernt. Bitte verwenden Sie stattdessen das Feld views.
water landscape city golf park
viewsstring[]erforderlich
Liste der Ausblicke von der Immobilie.
water landscape city golf park
directionZeichenfolgeerforderlich
Himmelsrichtung, in die die Immobilie ausgerichtet ist. Dieses Feld ist veraltet und wird mit dem nächsten größeren Update entfernt. Bitte verwenden Sie stattdessen das Feld directions.
north south east west
directionsstring[]erforderlich
Liste der Himmelsrichtungen, in die das Objekt ausgerichtet ist.
north south east west
characteristicsstring[]erforderlich
Eigenschaften der Immobilie.
balcony elevator no_elevator garage garden parking storage swimming_pool terrace rental_license furniture rented_out life_annuity
conditionZeichenfolgeerforderlich
Objektzustand, wie vom Endpunkt GET /v1/references/conditions zurückgegeben.
used ruin very-good new other
sale_time_on_marketobjecterforderlich
Informationen zur letzten Aktivität der Immobilie auf dem Verkaufsmarkt.
4 Immobilien
date_startstring (Datum)erforderlich
Beginndatum der Marktaktivität.
date_endstring (Datum)erforderlich
Enddatum der Marktaktivität.
days_on_marketintegererforderlich
Anzahl der Tage, die die Immobilie auf dem Markt war bzw. ist.
has_untracked_periodbooleanerforderlich
Gibt an, ob die Immobilie bereits auf dem Markt war, als die Nachverfolgung begann.
rent_time_on_marketobjecterforderlich
Informationen zur letzten Aktivität der Immobilie auf dem Mietmarkt.
4 Immobilien
date_startstring (Datum)erforderlich
Beginndatum der Marktaktivität.
date_endstring (Datum)erforderlich
Enddatum der Marktaktivität.
days_on_marketintegererforderlich
Anzahl der Tage, die die Immobilie auf dem Markt war bzw. ist.
has_untracked_periodbooleanerforderlich
Gibt an, ob die Immobilie bereits auf dem Markt war, als die Nachverfolgung begann.
listingsobject[]erforderlich
Die Liste der mit der Immobilie verknüpften Inserate.
41 properties
listing_idintegererforderlich
ID des Inserats.
total_areaintegererforderlich
Gesamtfläche.
plot_areaintegererforderlich
Grundstücksfläche.
terrace_areaintegererforderlich
Terrassenfläche.
bedroomsintegererforderlich
Anzahl der Schlafzimmer.
bathroomsintegererforderlich
Anzahl der Badezimmer.
roomsintegererforderlich
Anzahl der Zimmer.
sale_statusZeichenfolgeerforderlich
Aktueller Verkaufsstatus des Inserats.
active reserved hold sold none
sale_currencyZeichenfolgeerforderlich
Währungscode des Verkaufspreises.
sale_priceintegererforderlich
Aktueller Verkaufspreis in der Währung des Inserats (angegeben durch das Feld sale_currency).
sale_price_baseintegererforderlich
Aktueller Verkaufspreis in Euro.
rent_statusZeichenfolgeerforderlich
Aktueller Mietstatus des Inserats.
active reserved hold rented none
rent_currencyZeichenfolgeerforderlich
Währungscode des Mietpreises.
rent_priceintegererforderlich
Aktueller Mietpreis in der Währung des Inserats (angegeben durch das Feld rent_currency).
rent_price_baseintegererforderlich
Aktueller Mietpreis in Euro.
agency_legal_idZeichenfolgeerforderlich
Die in der Quelle angegebene rechtliche Identifikationsnummer der Agentur. Nur für Frankreich und dessen Überseegebiete (DROM und COM).
agencyZeichenfolgeerforderlich
Das Unternehmen, das das Inserat verwaltet.
listing_urlZeichenfolgekann null sein
URL des Inserats. Nur für aktuell aktive Inserate verfügbar.
listing_old_urlZeichenfolgekann null sein
Alte URL des Inserats. Nur für aktuell inaktive Inserate verfügbar.
descriptionZeichenfolgeerforderlich
Immobilienbeschreibung.
listing_uidZeichenfolgeerforderlich
Eindeutige ID des Inserats auf der Quell-Website.
construction_yearintegererforderlich
Baujahr.
source_nameZeichenfolgeerforderlich
Der Name der Quelle, auf der das Inserat angezeigt wird.
contacts_infoobjecterforderlich
Informationen zu den Kontaktpersonen des Inserats.
3 Immobilien
nameZeichenfolgeerforderlich
Name des Eigentümers. Nur für Inserate von privat.
emailZeichenkette (E-Mail)erforderlich
Die E-Mail-Kontaktadresse.
phoneZeichenfolgeerforderlich
Die Telefonnummer.
energy_certificateZeichenfolgeerforderlich
Energieausweis-Klassifizierung, die die Energieeffizienz einer Immobilie bescheinigt. Dieses Feld ist veraltet und wird im nächsten größeren Update entfernt. Bitte verwenden Sie stattdessen das Feld energy_rating.
energy_ratingZeichenfolgeerforderlich
Energiekennwert, der die Energieeffizienz einer Immobilie bescheinigt.
heating_typeZeichenfolgeerforderlich
Heizungsart.
ceiling_labelZeichenfolgeerforderlich
Deckenhöhe in Metern. Nur für Deutschland verfügbar.
commissionnumbererforderlich
Prozentsatz der Provision. Nur für Deutschland verfügbar.
min_rent_areaintegererforderlich
Minimale Mietfläche in Quadratmetern (hauptsächlich für Gewerbeimmobilien relevant). Nur für Deutschland verfügbar.
companiesobject[]erforderlich
Unternehmen, zu denen das Inserat gehört.
2 Eigenschaften
nameZeichenfolgeerforderlich
Name des Unternehmens.
casafari_connect_onbooleanerforderlich
Gibt an, ob das Unternehmen mit Casafari Connect verbunden ist.
created_atstring (Datum)erforderlich
Datum und Uhrzeit, an dem das Inserat hinzugefügt wurde.
floor_numberintegererforderlich
Genaue Etagenangabe. Negative Werte stehen für Untergeschosse (z. B. Keller).
is_privatebooleanerforderlich
Gibt an, ob das Inserat von einer Privatperson oder von einem Makler bzw. Profi aufgegeben wurde.
casafari_connectbooleanerforderlich
Gibt an, ob das Unternehmen mit Casafari Connect verbunden ist.
thumbnailsstring[]
Liste der URLs für Vorschaubilder.
picturesstring[]
Liste der URLs für die Originalbilder.
ref_numbersstring[]
List of reference numbers.
is_private_propertybooleanerforderlich
Gibt an, ob das Inserat von einer Privatperson oder von einem Makler bzw. Profi aufgegeben wurde.
is_auction_propertybooleanerforderlich
Whether the listing is an auction property.
is_bank_propertybooleanerforderlich
Whether the listing is a bank property.
historyobject[]
Liste der Verkaufs- und Mietpreishistorie. Dieses Feld ist veraltet und wird mit dem nächsten größeren Update entfernt. Bitte verwenden Sie stattdessen das Feld sale_price_history and rent_price_history.
Standard []
5 Eigenschaften
sale_priceintegererforderlich
Verkaufspreis in der Währung des Inserats (festgelegt durch das Feld sale_currency).
sale_currencyZeichenfolgeerforderlich
Währungscode des Verkaufspreises.
rent_priceintegererforderlich
Mietpreis in der Währung der Inserate (angegeben durch das Feld rent_currency).
rent_currencyZeichenfolgeerforderlich
Währungscode des Mietpreises.
changed_atstring (Datum)erforderlich
Datum der letzten Aktualisierung des Immobilienobjekts.
sale_price_historyobject[]
Liste der Kaufpreishistorie.
Standard []
4 Immobilien
date_startstring (Datum)erforderlich
Startdatum, ab dem die Änderung angewendet wurde.
date_endstring (Datum)erforderlich
Enddatum, bis zu dem die Änderung angewendet wurde.
sale_price_oldintegererforderlich
Alter Kaufpreis in der Währung des Inserats.
sale_price_newintegererforderlich
Neuer Kaufpreis in der Währung des Inserats.
rent_price_historyobject[]
Liste der Mietpreishistorie.
Standard []
4 Immobilien
date_startstring (Datum)erforderlich
Startdatum, ab dem die Änderung angewendet wurde.
date_endstring (Datum)erforderlich
Enddatum, bis zu dem die Änderung angewendet wurde.
rent_price_oldintegererforderlich
Alter Mietpreis in der Währung des Inserats.
rent_price_newintegererforderlich
Neuer Mietpreis in der Währung des Inserats.
sale_status_historyobject[]
Liste der Historie zum Verkaufsstatus.
Standard []
4 Immobilien
date_startstring (Datum)erforderlich
Startdatum, ab dem die Änderung angewendet wurde.
date_endstring (Datum)erforderlich
Enddatum, bis zu dem die Änderung angewendet wurde.
sale_status_oldZeichenfolgeerforderlich
Alter Verkaufsstatus, in der Währung der Inserate.
sale_status_newZeichenfolgeerforderlich
Neuer Verkaufsstatus, in der Währung der Inserate.
rent_status_historyobject[]
Liste der Historie des Mietstatus.
Standard []
4 Immobilien
date_startstring (Datum)erforderlich
Startdatum, ab dem die Änderung angewendet wurde.
date_endstring (Datum)erforderlich
Enddatum, bis zu dem die Änderung angewendet wurde.
rent_status_oldZeichenfolgeerforderlich
Alter Mietstatus, in der Währung der Inserate.
rent_status_newZeichenfolgeerforderlich
Neuer Mietstatus, in der Währung der Inserate.
property_urlZeichenfolgekann null sein
URL der Immobilie auf der CASAFARI-Website.
addressZeichenfolgeerforderlich
Objektadresse.
zip_codeZeichenfolgeerforderlich
Die Postleitzahl des Standorts.
distancenumberkann null sein
Entfernung in Kilometern vom Zielpunkt zur Immobilie. Nur verfügbar, wenn das Feld custom_location_boundary.circle in der Anfrage definiert ist.
descriptionZeichenfolgeerforderlich
Immobilienbeschreibung.
construction_yearintegererforderlich
Baujahr.
rent_price_baseintegererforderlich
Aktueller Mietpreis in Euro.
rent_price_per_sqmnumbererforderlich
Aktueller Mietpreis pro Quadratmeter in der Währung der Inserate (angegeben durch das Feld rent_currency).
rent_price_per_sqm_basenumbererforderlich
Aktueller Mietpreis pro Quadratmeter in Euro.
sale_price_baseintegererforderlich
Aktueller Verkaufspreis in Euro.
sale_price_per_sqmnumbererforderlich
Aktueller Verkaufspreis pro Quadratmeter in der Währung der Inserate (angegeben durch das Feld sale_currency).
sale_price_per_sqm_basenumbererforderlich
Aktueller Verkaufspreis pro Quadratmeter in Euro.
is_auction_propertybooleanerforderlich
Gibt an, ob es sich um eine Auktionsimmobilie handelt.
is_bank_propertybooleanerforderlich
Gibt an, ob es sich um eine Bankimmobilie handelt.
changed_atstring (Datum)erforderlich
Datum und Uhrzeit der letzten Aktualisierung der Immobilie.
sale_price_last_changeobjecterforderlich
Informationen zur letzten Verkaufspreisänderung.
3 Immobilien
change_datestring (Datum)erforderlich
Datum der Preisänderung.
old_valueintegererforderlich
Wert vor der Änderung.
new_valueintegererforderlich
Wert nach der Änderung.
rent_price_last_changeobjecterforderlich
Informationen zur letzten Mietpreisänderung.
3 Immobilien
change_datestring (Datum)erforderlich
Datum der Preisänderung.
old_valueintegererforderlich
Wert vor der Änderung.
new_valueintegererforderlich
Wert nach der Änderung.
thumbnailsstring[]
Liste der URLs für Vorschaubilder.
picturesstring[]
Liste der URLs für die Originalbilder.
gross_yieldnumbererforderlich
Bruttomietrendite in Prozent.
titleZeichenfolgeerforderlich
Immobilientitel.
energy_certificateZeichenfolgeerforderlich
Energieausweis-Klassifizierung, die die Energieeffizienz einer Immobilie bescheinigt. Dieses Feld ist veraltet und wird im nächsten größeren Update entfernt. Bitte verwenden Sie stattdessen das Feld energy_rating.
energy_ratingZeichenfolgeerforderlich
Energiekennwert, der die Energieeffizienz einer Immobilie bescheinigt.
ceiling_labelZeichenfolgeerforderlich
Deckenhöhe in Metern. Nur für Deutschland verfügbar.
min_rent_areaintegererforderlich
Minimale Mietfläche in Quadratmetern (hauptsächlich für Gewerbeimmobilien relevant). Nur für Deutschland verfügbar.
ref_numbersstring[]
Liste der Referenznummern aus Inseraten.
casafari_connectbooleanerforderlich
Gibt an, ob das Unternehmen mit Casafari Connect verbunden ist.
source_floor_numbersinteger[]
Liste der Stockwerke der Immobilie basierend auf Inseratsdaten. Negative Werte kennzeichnen Untergeschosse (z. B. Keller).
Standard []
retail_dataobjectkann null sein
Einzelhandelsbezogene Attribute der Immobilie. Null bei nicht-gewerblichen Immobilien oder wenn keine Einzelhandelsdaten verfügbar sind.
6 Immobilien
facade_measurementsobjecterforderlich
Fassadenmaße der Gewerbeimmobilie (Höhe, Länge, Fläche in Metern).
3 Immobilien
heightnumbererforderlich
Fassadenhöhe in Metern.
lengthnumbererforderlich
Fassadenlänge in Metern.
surfacenumbererforderlich
Fassadenfläche in Quadratmetern.
transfer_price_rangeobjecterforderlich
Preisspanne, falls die Immobilie zur Übernahme verfügbar ist.
2 Eigenschaften
gteintegererforderlich
Untergrenze der Übernahmepreisspanne.
lteintegererforderlich
Obergrenze der Übernahmepreisspanne.
is_street_levelbooleanerforderlich
Gibt an, ob sich der gewerbliche Eingang auf Straßenniveau befindet, ohne dass Treppen genutzt werden müssen.
number_of_floorsintegererforderlich
Anzahl der Etagen der Gewerbeimmobilie.
number_of_premisesintegererforderlich
Anzahl der nutzbaren Räume oder Flächen der Immobilie.
possible_business_typesstring[]erforderlich
Art der gewerblichen Nutzung, die in dieser Immobilie möglich ist oder ausgeübt wurde (z. B. Café, Restaurant, Lebensmittelgeschäft, Zahnarztpraxis).

401 Nicht autorisiert

Typ: object.

Antwortstruktur anzeigen (1 Feld)
detailZeichenfolge
Beschreibung des aufgetretenen Fehlers.

403 Unzulässig

Typ: object.

Antwortstruktur anzeigen (1 Feld)
detailZeichenfolge
Beschreibung des aufgetretenen Fehlers.

404 Nicht gefunden

Typ: object.

Antwortstruktur anzeigen (1 Feld)
errorsobject
Beschreibung der aufgetretenen Fehler.

Tipp: Fügen Sie .md an eine URL an, um den Inhalt als Markdown zu lesen.