Platform

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

Claro AI · REST API

List this account's alerts

GEThttps://platform.casafari.com/v1/claro/alerts/feed
API key2 parameters

Send 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.

Query parameters

sincestring
Only items after this date or timestamp (2026-11-01 or 2026-11-01T06:30:00Z). Leave out for the last 30 days.
limitinteger
At most this many items; a page never ends inside one digest. Pass next_since as since to read on.
1–200default 100

Example request

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

curl
curl "https://platform.casafari.com/v1/claro/alerts/feed" \
  -H "Authorization: Bearer $CASAFARI_API_KEY"

Responses

200 List this account's alerts

No body.

Example from the API description (long arrays shortened)
JSON
{
  "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 Invalid request

Type: object.

Show the response shape (3 fields)
errorobject
2 properties
codestringrequired
messagestringrequired

401 Missing or invalid key

Type: object.

Show the response shape (3 fields)
errorobject
2 properties
codestringrequired
messagestringrequired

403 No access

Type: object.

Show the response shape (3 fields)
errorobject
2 properties
codestringrequired
messagestringrequired

429 Rate limited

Type: object.

Show the response shape (3 fields)
errorobject
2 properties
codestringrequired
messagestringrequired

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