Bestehende Casafari API · API v1 · Alerts
Search alerts
https://api.casafari.com/v1/listing-alerts/searchSenden 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: POST /api/v1/listing-alerts/search.
Description
Returns paginated list of alerts (by requested parameters) for currently authenticated user.
Abfrageparameter
limitintegeroffsetintegerorder_byZeichenfolgealert_date -alert_date alert_id -alert_id created_at -created_at updated_at -updated_atalert_subtypeZeichenfolgealert_subtypes field in the body parameters instead.new price_up price_down reserved delisted soldRequest-Body
Content-Type application/json. Optional. Typ: object.
operationZeichenfolgeerforderlichsale rentlocation_idsinteger[]custom_locationobject[]custom_locations.2 Eigenschaften
latitudenumbererforderlichlongitudenumbererforderlichcustom_locationsobject[][]2 Eigenschaften
latitudenumbererforderlichlongitudenumbererforderlichtypesstring[]40 zulässige Werte
apartment 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_buildingconditionsstring[]used ruin very-good new otheralert_date_fromstring (Datum)YYYY-MM-DD) des Zeitraums für die gewünschten Alerts.alert_date_tostring (Datum)YYYY-MM-DD) des Zeitraums für die gewünschten Alerts.created_at_fromstring (Datum-Zeit)YYYY-MM-DDTHH:mm:ss), um Alerts nach ihrer Erstellung in der Datenbank (UTC) zu filtern. Nützlich für die inkrementelle Synchronisierung, um das Abrufen bereits vorhandener Daten zu vermeiden.created_at_tostring (Datum-Zeit)YYYY-MM-DDTHH:mm:ss), um Alerts nach ihrer Erstellung in der Datenbank (UTC) zu filtern. Nützlich für die inkrementelle Synchronisierung, um das Abrufen bereits vorhandener Daten zu vermeiden.created_at_with_photos_fromstring (Datum-Zeit)created_at_with_photos_tostring (Datum-Zeit)statusesstring[]active reserved hold sold rentedprice_fromintegerprice_tointegerprice_per_sqm_fromintegerprice_per_sqm_tointegerbedrooms_fromintegerbedrooms_tointegerbathrooms_fromintegerbathrooms_tointegertotal_area_fromintegertotal_area_tointegerplot_area_fromintegerplot_area_tointegerconstruction_year_fromintegerconstruction_year_tointegerfloorZeichenfolgefloors.no_floor ground middle topfloorsstring[]no_floor ground middle toporientationZeichenfolgeexterior interiorviewZeichenfolgeviews field instead."water landscape city golf parkviewsstring[]water landscape city golf parkdirectionZeichenfolgedirections field instead.north south east westdirectionsstring[]north south east westcharacteristicsstring[]balcony elevator no_elevator garage garden parking storage swimming_pool terrace rental_license furniture rented_out life_annuityalert_subtypesstring[]new price_up price_down reserved delisted soldprivatebooleanauctionbooleanbankbooleannew_developmentbooleanlisting_agentsstring[]with_agenciesstring[]without_agenciesstring[]exclusivebooleanprivate, with_agencies oder without_agencies übergeben werden.ref_numbersstring[]has_phonebooleanphone-Nummer zurückgegeben werden.has_emailbooleanhas_agency_namebooleanproperty_idsinteger[]listing_idsinteger[]Beispielanfrage
Nur Platzhalter: Ersetzen Sie das Token und die Werte durch Ihre eigenen.
curl -X POST "https://api.casafari.com/v1/listing-alerts/search" \
-H "Authorization: Token $CASAFARI_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"operation": "sale",
"types": [
"apartment",
"studio",
"duplex",
"penthouse"
],
"location_ids": [
2942,
1861,
1600
],
"conditions": [
"used",
"very-good",
"new"
],
"statuses": [
"active",
"reserved"
],
"price_from": 150000,
"price_to": 800000,
"price_per_sqm_from": 2000,
"price_per_sqm_to": 8000,
"bedrooms_from": 1,
"bedrooms_to": 3,
"total_area_from": 30,
"total_area_to": 130,
"construction_year_from": 1950,
"floors": [
"middle",
"top"
],
"views": [
"city"
],
"directions": [
"west",
"south"
],
"characteristics": [
"balcony",
"elevator",
"parking"
],
"private": false,
"new_development": false,
"has_agency_name": true,
"has_email": false,
"without_agencies": [
"Airbnb",
"Casa.Sapo"
],
"alert_date_from": "2021-09-01"
}'Antworten
200
Typ: object[].
Show the response shape (91 fields)
countintegernextZeichenkette (URI)kann null seinpreviousZeichenkette (URI)kann null seinresultsobject67 properties
alert_idintegererforderlichlisting_idintegererforderlichrefZeichenfolgeerforderlichalert_typeZeichenfolgeerforderlichsale_price sale_status rent_price rent_status newalert_subtypeZeichenfolgeerforderlichnew price_up price_down reserved delisted soldold_valueZeichenfolgeerforderlichnew_valueZeichenfolgeerforderlichalert_datestring (Datum)erforderlichalert_date_and_timeZeichenfolgekann null seinproperty_urlZeichenfolgekann null seinlisting_urlZeichenfolgekann null seinlisting_old_urlZeichenfolgekann null seinlisting_uidZeichenfolgeerforderlichproperty_idintegererforderlichtitleZeichenfolgeerforderlichtypeZeichenfolgeerforderlich40 zulässige Werte
apartment 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_buildingtype_groupZeichenfolgeerforderlichlocationobjecterforderlich4 Immobilien
location_idintegererforderlichnameZeichenfolgeerforderlichadministrative_levelZeichenfolgeerforderlichzip_codesstring[]locations_structureobject[]erforderlich4 Immobilien
location_idintegererforderlichnameZeichenfolgeerforderlichadministrative_levelZeichenfolgeerforderlichzip_codesstring[]addressZeichenfolgeerforderlichzip_codeZeichenfolgeerforderlichcadastral_referenceZeichenfolgeerforderlichcoordinatesobjecterforderlich2 Eigenschaften
latitudenumbererforderlichlongitudenumbererforderlichconditionZeichenfolgeerforderlichused ruin very-good new othercontacts_infoobjecterforderlich3 Immobilien
nameZeichenfolgeerforderlichemailZeichenkette (E-Mail)erforderlichphoneZeichenfolgeerforderlichtotal_areaintegererforderlichliving_areaintegererforderlichplot_areaintegererforderlichterrace_areaintegererforderlichbedroomsintegererforderlichroomsintegererforderlichbathroomsintegererforderlichfeaturesobjecterforderlich7 Immobilien
floorZeichenfolgeerforderlichno_floor ground middle toporientationZeichenfolgeerforderlichexterior interiorviewZeichenfolgeerforderlichviews.water landscape city golf parkviewsstring[]erforderlichwater landscape city golf parkdirectionZeichenfolgeerforderlichdirections.north south east westdirectionsstring[]erforderlichnorth south east westcharacteristicsstring[]erforderlichbalcony elevator no_elevator garage garden parking storage swimming_pool terrace rental_license furniture rented_out life_annuityconstruction_yearintegererforderlichoperationsstring[]erforderlichsale rentis_bank_propertybooleanerforderlichis_auction_propertybooleanerforderlichis_new_development_propertybooleanerforderlichis_private_propertybooleanerforderlichsale_statusZeichenfolgeerforderlichactive reserved hold sold nonesale_currencyZeichenfolgeerforderlichsale_price_baseintegererforderlichsale_priceintegererforderlichsale_currency).sale_price_per_sqmnumbererforderlichsale_currency field).sale_price_per_sqm_basenumbererforderlichrent_statusZeichenfolgeerforderlichactive reserved hold rented nonerent_currencyZeichenfolgeerforderlichrent_price_baseintegererforderlichrent_priceintegererforderlichrent_currency).rent_price_per_sqmnumbererforderlichrent_currency field).rent_price_per_sqm_basenumbererforderlichrent_periodZeichenfolgeerforderlichday week fortnight month year noneagency_legal_idZeichenfolgeerforderlichagencyZeichenfolgeerforderlichagentZeichenfolgeerforderlichsource_nameZeichenfolgeerforderlichdescriptionZeichenfolgeerforderlichthumbnailsstring[]picturesstring[]created_atstring (Datum-Zeit)erforderlichcreated_at_with_photosstring (Datum-Zeit)erforderlichnull if photo processing has not finished yet.
If the listing has no photos but the system has finished the processing, this field will contain its date and time.updated_atstring (Datum-Zeit)erforderlichenergy_certificateZeichenfolgeerforderlichenergy_rating field instead.energy_ratingZeichenfolgeerforderlichheating_typeZeichenfolgeerforderlichavailable_fromstring (Datum)erforderlichavailable_tostring (Datum)erforderlichBeispiel aus der API-Beschreibung (lange Arrays gekürzt)
{
"count": 79,
"next": "https://api.casafari.com/v1/listing-alerts/search?limit=50&offset=50",
"previous": null,
"results": [
{
"alert_id": 412269711,
"listing_id": 110358519,
"title": "Apartamento T2 em Santa Engracia",
"ref": "ID-124021076-47",
"alert_type": "sale_price",
"alert_subtype": "price_down",
"old_value": "549000",
"new_value": "545000",
"alert_date": "2021-10-24",
"alert_date_and_time": "2021-10-24T05:37:09",
"created_at": "2021-10-24T05:38:53.273581",
"created_at_with_photos": "2021-10-24T05:43:27.622175",
"updated_at": "2021-04-05T17:47:19.191211",
"property_url": "https://www.casafari.com/home-sale/property-51277418",
"listing_url": "https://portal.example/listing",
"listing_old_url": null,
"listing_uid": "1054046",
"property_id": 51277418,
"type": "apartment",
"type_group": "apartment",
"location": {
"location_id": 28649,
"name": "Santa Engrácia",
"administrative_level": "Localidade",
"zip_codes": []
},
"locations_structure": [
{
"location_id": 499,
"name": "Portugal",
"administrative_level": "País",
"zip_codes": [
"1200-224"
]
}
],
"address": "",
"zip_code": "80804",
"cadastral_reference": "2181605VK4728A0001TA",
"coordinates": {
"latitude": 38.7194,
"longitude": -9.12209
},
"condition": "used",
"contacts_info": {
"name": null,
"email": null,
"phone": "215551538"
},
"total_area": 130,
"living_area": 128,
"plot_area": 0,
"terrace_area": 15,
"bedrooms": 3,
"rooms": 0,
"bathrooms": 2,
"features": {
"floor": "middle",
"orientation": null,
"views": [
"city"
],
"directions": [
"west"
],
"characteristics": [
"balcony"
]
},
"construction_year": 2015,
"operations": [
"sale"
],
"is_bank_property": false,
"is_auction_property": false,
"is_new_development_property": false,
"is_private_property": false,
"sale_status": "active",
"sale_currency": "EUR",
"sale_price": 545000,
"sale_price_base": 545000,
"sale_price_per_sqm": 4192,
"sale_price_per_sqm_base": 4192,
"rent_status": "none",
"rent_currency": "EUR",
"rent_price": 0,
"rent_price_base": 0,
"rent_price_per_sqm": 0,
"rent_price_per_sqm_base": 0,
"rent_period": "none",
"agency_legal_id": "402016653",
"agency": "Helena Almeida Pires",
"agent": "",
"source_name": "Portal",
"description": "O apartamento é composto de sala de estar e jantar ampla, com janelas de vidro duplo que dão enorme luminosidade, ao ambiente.",
"thumbnails": [
"https://st2.retelligence.co/c/2875/4/7f/5a0fc6ebf8e4e41d062342a29b50647f350.jpg"
],
"pictures": [
"https://media.casasapo.pt/Z1140x855/Wnone/S5/C2729/P20091734/Tphoto/ID56933201-0000-0500-0000-00000d1ffcdc.jpg"
],
"energy_certificate": "B",
"energy_rating": "B",
"heating_type": "Central heating",
"available_from": "2026-07-01",
"available_to": "2027-06-30"
}
]
}400 Ungültige Anfrage
Typ: object.
Antwortstruktur anzeigen (1 Feld)
errorsobject401 Nicht autorisiert
Typ: object.
Antwortstruktur anzeigen (1 Feld)
detailZeichenfolge403 Unzulässig
Typ: object.
Antwortstruktur anzeigen (1 Feld)
detailZeichenfolge