List this account's alerts
https://platform.casafari.com/v1/claro/alerts/feedSend Authorization: Bearer $CASAFARI_API_KEY: a platform API key or OAuth access token, metered in platform tokens; see platform sign-in and Claro AI. On the platform this is GET https://platform.casafari.com/v1/claro/alerts/feed; GET /v1/alerts/feed is Claro's own path, which the platform adds /claro to. The platform forwards the call to Claro unchanged: Claro's Claro-Version header and its error bodies ({"error":{"code","message"}}, with rate_limited and quota_reached on a 429) pass through.
Over MCP: alerts (equivalent). MCP and REST compared.
Description
The account's alert feed, oldest first: what Claro's email alerts told its people since since. Kinds: new_match (a unit new to the market that matches a saved search), price_cut_match and price_cut_saved (an asking rent or price cut by 3% or more, on a match or on a premises someone saved; cut has the old and new price, the percentage and the area's median asking price per m² when it rests on 10 or more units), saved_premises (a saved premises left the market, after days_on_market days, or came back; no reason is given) and area_pulse (new and withdrawn units, stock and median asking price per m² against the last pulse; rivals' places found in or no longer in an Overture Maps release; a footfall change only when a new Location Intelligence year landed). Units carry the pm_ id, price with price per m², days on the market, the agency and its listing_url; location figures only for accounts with location access. No descriptions or photos. Pass next_since from the answer as since to read on.
Queryparameters
sincestringlimitintegernext_since as since to read on.Voorbeeld van een aanvraag
Enkel placeholders: vervang het token en de waarden door uw eigen gegevens.
curl "https://platform.casafari.com/v1/claro/alerts/feed" \
-H "Authorization: Bearer $CASAFARI_API_KEY"Antwoorden
200 List this account's alerts
Geen body.
Voorbeeld uit de API-beschrijving (lange arrays ingekort)
{
"items": [
{
"id": "price_cut_match:3f9a1c2e:pm_3kX9vQ2LmT8a:4140",
"created_at": "2026-11-02T06:30:00.000Z",
"kind": "price_cut_match",
"token": "pm_3kX9vQ2LmT8a",
"scope": "premises",
"alert_id": "Zk3m9XpQ1aVb7LwE",
"title": "Local comercial en esquina",
"place": "Centro, madrid",
"area_m2": 150,
"price": {
"op": "rent",
"eur": 4140,
"eur_per_m2": 27.6
},
"days_on_market": 63,
"why": [
"price",
"street_level"
],
"location": {
"kind": "passers_by",
"per_day": 4200
},
"agency": "Agencia Sol",
"listing_url": "https://agenciasol.es/1",
"cut": {
"from_eur": 4500,
"to_eur": 4140,
"pct": 8,
"area_median": {
"eur_per_m2": 31.2,
"n": 84
}
}
},
{
"id": "saved_premises:3f9a1c2e:pm_7Rt2xLmN8bV4:withdrawn:2026-11-02",
"created_at": "2026-11-02T06:30:00.000Z",
"kind": "saved_premises",
"token": "pm_7Rt2xLmN8bV4",
"alert_id": "Qw7rT2xLmN8bV4cZ",
"change": "withdrawn",
"title": "Nave industrial",
"place": "Getafe",
"days_on_market": 112
}
],
"next_since": "2026-11-02T06:30:00.000Z"
}400 Ongeldig verzoek
Type: object.
Toon de structuur van het antwoord (3 velden)
errorobject2 eigenschappen
codestringvereistmessagestringvereist401 Ontbrekende of ongeldige sleutel
Type: object.
Toon de structuur van het antwoord (3 velden)
errorobject2 eigenschappen
codestringvereistmessagestringvereist403 Geen toegang
Type: object.
Toon de structuur van het antwoord (3 velden)
errorobject2 eigenschappen
codestringvereistmessagestringvereist429 Rate limited
Type: object.
Toon de structuur van het antwoord (3 velden)
errorobject2 eigenschappen
codestringvereistmessagestringvereist