Platform
Get started

Casafari is the AI agent-native real estate data intelligence platform. The most complete property index in Europe: a deduplicated, cleaned property graph of residential and commercial property, for sale and for rent, in 16 countries.The most complete property index in Europe: a deduplicated, cleaned property graph.

How the graph is built
Markdown Open in Claude Open in ChatGPT

Existing Casafari API · API v1 · Alerts

Get alerts by feed

GEThttps://api.casafari.com/v1/listing-alerts/feeds/{id}
Static token11 parametersAPI v1

Send Authorization: Token $CASAFARI_TOKEN with your existing API token; see where to get it.

The same path under /api, signed in with a bearer token, is in the REST API reference: GET /api/v1/listing-alerts/feeds/{id}.

Description

Returns paginated list of alerts (by feed ID) for currently authenticated user.

Path parameters

idstringrequired
A unique integer value identifying this alerts feed.

Query parameters

limitinteger
Number of results to return per page.
offsetinteger
Offset from which to start the search. Maximum value is 50000.
order_bystring
The field by which to sort the results.
alert_date -alert_date alert_id -alert_id created_at -created_at updated_at -updated_at
default "-alert_date"
alert_date_fromstring (date)
Start date (in the format YYYY-MM-DD) of the period for alerts of interest. Overrides alert_date_from value if it was specified in the feed filter. Invalid values are ignored.
alert_date_tostring (date)
End date (in the format YYYY-MM-DD) of the period for alerts of interest. Overrides alert_date_to value if it was specified in the feed filter. Invalid values are ignored.
created_at_fromstring (date-time)
Start date and time (in the format YYYY-MM-DDTHH:mm:ss) to filter alerts by their creation in the database (UTC). Useful for incremental sync to avoid fetching already fetched data. Overrides created_at_from value if it was specified in the feed filter. Invalid values are ignored.
created_at_tostring (date-time)
End date and time (in the format YYYY-MM-DDTHH:mm:ss) to filter alerts by their creation in the database (UTC). Useful for incremental sync to avoid fetching already fetched data. Overrides created_at_to value if it was specified in the feed filter. Invalid values are ignored.
created_at_with_photos_fromstring (date-time)
Start date and time (in the format YYYY-MM-DDTHH:mm:ss) to filter alerts by their creation in the database (UTC), only including alerts for which photo processing has been completed. Use it to fetch alerts with already assigned photos. Note: Some alerts may still not have photos if the original listing did not include any. Overrides created_at_with_photos_from value if it was specified in the feed filter. Invalid values are ignored.
created_at_with_photos_tostring (date-time)
End date and time (in the format YYYY-MM-DDTHH:mm:ss) to filter alerts by their creation in the database (UTC), only including alerts for which photo processing has been completed. Use it to fetch alerts with already assigned photos. Note: Some alerts may still not have photos if the original listing did not include any. Overrides created_at_with_photos_to value if it was specified in the feed filter. Invalid values are ignored.
alert_subtypestring
Get only alerts of the specific subtype (for the requested feed). Invalid values are ignored. This field is deprecated and will be removed in the next major update. Please, use alert_subtypes field in the feed.filter instead.
new price_up price_down reserved delisted sold

Example request

Placeholders only: replace the token and the values with your own.

curl
curl "https://api.casafari.com/v1/listing-alerts/feeds/<id>" \
  -H "Authorization: Token $CASAFARI_TOKEN"

Responses

200

Type: object[].

Show the response shape (91 fields)
countinteger
nextstring (uri)nullable
previousstring (uri)nullable
resultsobject
67 properties
alert_idintegerrequired
ID of the alert.
listing_idintegerrequired
ID of the listing (ad).
refstringrequired
The reference ID of the listing.
alert_typestringrequired
The type of the alert.
sale_price sale_status rent_price rent_status new
alert_subtypestringrequired
The subtype of the alert.
new price_up price_down reserved delisted sold
old_valuestringrequired
Value before change.
new_valuestringrequired
Value after change.
alert_datestring (date)required
Date when the alert occurred.
alert_date_and_timestringnullable
Date and time when the alert occurred.
property_urlstringnullable
URL of the property in the CASAFARI website.
listing_urlstringnullable
URL of the listing. Available only for currently active listings.
listing_old_urlstringnullable
Old URL of the listing. Available only for currently inactive listings.
listing_uidstringrequired
Unique ID of the listing on the source site.
property_idintegerrequired
ID of the property to which the listing belongs.
titlestringrequired
Listing title.
typestringrequired
Listing property type, as returned by the GET /v1/references/types endpoint.
40 allowed valuesapartment 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_groupstringrequired
Listing property type group, as returned by the GET /v1/references/types endpoint.
locationobjectrequired
Information about property location.
4 properties
location_idintegerrequired
Location ID, as returned by the POST /v1/references/locations endpoint.
namestringrequired
Location name.
administrative_levelstringrequired
Location administrative level.
zip_codesstring[]
The location zip codes.
default []
locations_structureobject[]required
Information about all the parent locations (including property location) up to the country.
4 properties
location_idintegerrequired
Location ID, as returned by the POST /v1/references/locations endpoint.
namestringrequired
Location name.
administrative_levelstringrequired
Location administrative level.
zip_codesstring[]
The location zip codes.
default []
addressstringrequired
Property address.
zip_codestringrequired
The location zip code.
cadastral_referencestringrequired
Cadastral reference of the estate.
coordinatesobjectrequired
Property coordinates.
2 properties
latitudenumberrequired
Latitude.
longitudenumberrequired
Longitude.
conditionstringrequired
Property condition, as returned by the GET /v1/references/conditions endpoint.
used ruin very-good new other
contacts_infoobjectrequired
Information about listing contacts.
3 properties
namestringrequired
The owner name. Only for FSBO listings.
emailstring (email)required
The email contact.
phonestringrequired
The phone contact.
total_areaintegerrequired
Total area.
living_areaintegerrequired
Living area.
plot_areaintegerrequired
Plot area.
terrace_areaintegerrequired
Terrace area.
bedroomsintegerrequired
Number of bedrooms.
roomsintegerrequired
Number of rooms.
bathroomsintegerrequired
Number of bathrooms.
featuresobjectrequired
Property features, as returned by the GET /v1/references/features endpoint.
7 properties
floorstringrequired
Floor type.
no_floor ground middle top
orientationstringrequired
Property view orientation.
exterior interior
viewstringrequired
View from the property. This field is deprecated and will be removed in the next major update. Please, use views field instead.
water landscape city golf park
viewsstring[]required
List of views from the property.
water landscape city golf park
directionstringrequired
Cardinal direction the property faces. This field is deprecated and will be removed in the next major update. Please, use directions field instead.
north south east west
directionsstring[]required
List of cardinal directions the property faces.
north south east west
characteristicsstring[]required
Property characteristics.
balcony elevator no_elevator garage garden parking storage swimming_pool terrace rental_license furniture rented_out life_annuity
construction_yearintegerrequired
Construction year.
operationsstring[]required
Operation types for which listing property is available.
sale rent
is_bank_propertybooleanrequired
Whether the listing property is a bank property.
is_auction_propertybooleanrequired
Whether the listing property is an auction property.
is_new_development_propertybooleanrequired
Whether the listing property is a new development property.
is_private_propertybooleanrequired
Whether the property is listed by a private individual, as opposed to an agent or a professional.
sale_statusstringrequired
Current sale status of the listing.
active reserved hold sold none
sale_currencystringrequired
Sale price currency code.
sale_price_baseintegerrequired
Current sale price, in Euros.
sale_priceintegerrequired
Current sale price, in the currency of the listing (specified by the sale_currency field).
sale_price_per_sqmnumberrequired
Current sale price per square meter, in the currency of the listing (specified by the sale_currency field).
sale_price_per_sqm_basenumberrequired
Current sale price per square meter, in Euros.
rent_statusstringrequired
Current rent status of the listing.
active reserved hold rented none
rent_currencystringrequired
Rent price currency code.
rent_price_baseintegerrequired
Current rent price, in Euros.
rent_priceintegerrequired
Current rent price, in the currency of the listing (specified by the rent_currency field).
rent_price_per_sqmnumberrequired
Current rent price per square meter, in the currency of the listing (specified by the rent_currency field).
rent_price_per_sqm_basenumberrequired
Current rent price per square meter, in Euros.
rent_periodstringrequired
Rent period.
day week fortnight month year none
agency_legal_idstringrequired
Agency legal identifier specified on the source. Only for France and its overseas territories(DROM and COM).
agencystringrequired
The company that manages the listing.
agentstringrequired
The agent that manages the listing.
source_namestringrequired
The name of the source.
descriptionstringrequired
Listing description.
thumbnailsstring[]
List of the thumbnail image URLs.
picturesstring[]
List of the original picture image URLs.
created_atstring (date-time)required
Date and time when the alert was created (UTC).
created_at_with_photosstring (date-time)required
Date and time (UTC) when the alert was created and its photos were processed. Can be null 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 (date-time)required
Date and time when the alert data was updated (UTC).
energy_certificatestringrequired
Energy certificate classification that attests to the energy efficiency of a listing. This field is deprecated and will be removed in the next major update. Please, use energy_rating field instead.
energy_ratingstringrequired
Energy rating that attests to the energy efficiency of a listing.
heating_typestringrequired
Type of heating.
available_fromstring (date)required
The date the listing property becomes available for occupancy. The start of the availability window.
available_tostring (date)required
The date the listing property stops being available. The end of the availability window.
Example from the API description (long arrays shortened)
JSON
{
  "count": 79,
  "next": "http://api.casafari.com/v1/listing-alerts/feeds/887?alert_date_from=2021-09-01&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://www.idealista.pt/imovel/31407575/",
      "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": "Idealista",
      "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 Bad Request

Type: object.

Show the response shape (1 fields)
errorsobject
Description of the errors encountered.

401 Unauthorized

Type: object.

Show the response shape (1 fields)
detailstring
Description of the error encountered.

403 Forbidden

Type: object.

Show the response shape (1 fields)
detailstring
Description of the error encountered.

404 Not Found

Type: object.

Show the response shape (1 fields)
errorsobject
Description of the errors encountered.
Esc

Tip: add .md to any URL to read it as Markdown.