Platform

Casafari és la plataforma d'intel·ligència de dades immobiliàries nativa per a agents amb IA. L'índex de propietats més complet d'Europa: un graf immobiliari netejat i deduplicat de béns residencials i comercials, en venda i lloguer, en 16 països.L'índex de propietats més complet d'Europa: un graf immobiliari netejat i deduplicat.

Com es construeix el graf

Claro AI · REST API

List this account's alerts

GEThttps://platform.casafari.com/v1/claro/alerts/feed
Clau d'API2 paràmetres

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.

Paràmetres de consulta

sincecadena
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

Exemple de sol·licitud

Només espais reservats: substitueix el token i els valors pels teus.

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

Respostes

200 List this account's alerts

Sense cos.

Exemple de la descripció de l'API (arrays llargs escurçats)
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 Sol·licitud no vàlida

Tipus: object.

Mostra l'estructura de la resposta (3 camps)
errorobjecte
2 propietats
codecadenaobligatori
messagecadenaobligatori

401 Clau invàlida o absent

Tipus: object.

Mostra l'estructura de la resposta (3 camps)
errorobjecte
2 propietats
codecadenaobligatori
messagecadenaobligatori

403 Accés denegat

Tipus: object.

Mostra l'estructura de la resposta (3 camps)
errorobjecte
2 propietats
codecadenaobligatori
messagecadenaobligatori

429 Límit de peticions assolit

Tipus: object.

Mostra l'estructura de la resposta (3 camps)
errorobjecte
2 propietats
codecadenaobligatori
messagecadenaobligatori

Consell: afegeix .md a qualsevol URL per llegir-la com a Markdown.