Get feed
GET
https://api.casafari.com/alerts-api/feeds/{feed_id}Bearer token1 parameter
Send Authorization: Bearer $CASAFARI_TOKEN; see how to get a token.
Over MCP: no tool does this. MCP and REST compared.
Description
Returns the feed configuration in the same format as it was originally created. Filters that were not set at creation time are omitted entirely (not returned as null); filters explicitly set to null are returned as null.
Path parameters
feed_idintegerrequiredExample request
Placeholders only: replace the token and the values with your own.
curl "https://api.casafari.com/alerts-api/feeds/1" \
-H "Authorization: Bearer $CASAFARI_TOKEN"Responses
200 Successful Response
Type: object.
Show the response shape (47 fields)
feed_idintegerrequiredfeed_namestringrequiredfiltersobjectrequired28 properties
location_idsinteger[]nullable1–100 items
typesstring[]nullable42 allowed values
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 building other_commercial restaurant werkstatt urban_plot rural_plot room parking garage other apartment_building office_building mix_use_building apartment_development house_developmentat least 1 item
business_typestringrequiredsale rentstatuses(string | string)[]nullableat least 1 item
alert_subtypesstring[]nullablenew price_increased price_decreased reserved delisted soldcustom_locationsobject[][]nullableList of closed polygons of geo-points to search within. Each polygon must contain at least 4 points. First and last points must match in each polygon. Maximum 4 polygons allowed.
1–4 items4–25 items
2 properties
latitudenumberrequired-90–90
longitudenumberrequired-180–180
privatebooleannullableprice_rangeobjectnullable2 properties
minintegernullable1–2147483647
maxintegernullable1–2147483647
price_psqm_rangeobjectnullable2 properties
minintegernullable1–2147483647
maxintegernullable1–2147483647
bathrooms_rangeobjectnullable2 properties
minintegernullable1–15000
maxintegernullable1–15000
bedrooms_rangeobjectnullable2 properties
minintegernullable0–15000
maxintegernullable0–15000
total_area_rangeobjectnullable2 properties
minintegernullable1–1000000
maxintegernullable1–1000000
new_developmentbooleannullablebankbooleannullableauctionbooleannullableconstruction_year_rangeobjectnullable2 properties
minintegernullable1–3000
maxintegernullable1–3000
plot_area_rangeobjectnullable2 properties
minintegernullable1–1000000
maxintegernullable1–1000000
floorsstring[]nullableno_floor ground middle topat least 1 item
conditionsstring[]nullablenew used ruin very-good otherat least 1 item
orientationstringnullableexterior interiorviewsstring[]nullableA matching listing must have every requested view, not just one.
water landscape city golf parkat least 1 item
directionsstring[]nullableA matching listing must face every requested direction, not just one.
north south east westat least 1 item
characteristicsstring[]nullableA matching listing must have every requested characteristic, not just one.
balcony elevator no_elevator garage garden parking storage swimming_pool terrace rental_license furniture rented_out life_annuityat least 1 item
has_phonebooleannullablehas_emailbooleannullablehas_agency_namebooleannullableref_numbersstring[]nullable1–100 items
listing_idsinteger[]nullable1–100 items
404 Feed not found.
Type: object.
Show the response shape (1 fields)
detailstringrequiredExample from the API description
{
"detail": "Feed not found."
}422 Validation Error
Type: object.
Show the response shape (6 fields)
detailobject[]5 properties
loc(string | integer)[]requiredmsgstringrequiredtypestringrequiredinputanyctxobject