# Alerts

> **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. Every property is one record with its full price and market history. [How the property graph is built](/docs/property-graph).

Alert feeds that follow the property graph for a set of filters: new properties, price rises and cuts, reservations, delistings and sales. Create a feed, read its alerts, or have them delivered to your webhook.

12 REST operations.

## REST API

12 operations in the public OpenAPI description, all under `https://api.casafari.com` with a bearer token ([how to get one](/docs/rest#get-a-token)). The same list with more detail: [Alerts REST API](/docs/rest/alerts).

### Alerts

Paths under `/api/v1/listing-alerts`.

- [`GET /api/v1/listing-alerts/feeds`](/docs/rest/alerts/get-feeds-list-v1): Get feeds list (v1). Returns all alerts feeds for currently authenticated user.
- [`POST /api/v1/listing-alerts/feeds`](/docs/rest/alerts/create-feed-v1): Create feed (v1). Create alerts feed for currently authenticated user.
- [`GET /api/v1/listing-alerts/feeds/{id}`](/docs/rest/alerts/get-alerts-by-feed-v1): Get alerts by feed (v1). Returns paginated list of alerts (by feed ID) for currently authenticated user.
- [`DELETE /api/v1/listing-alerts/feeds/{id}`](/docs/rest/alerts/delete-feed-v1): Delete feed (v1). Delete alerts feed (by feed ID) for currently authenticated user.
- [`PUT /api/v1/listing-alerts/feeds/{id}/update`](/docs/rest/alerts/update-feed-v1): Update feed (v1). Update alerts feed by id.
- [`POST /api/v1/listing-alerts/search`](/docs/rest/alerts/search-alerts-v1): Search alerts (v1). Returns paginated list of alerts (by requested parameters) for currently authenticated user.

### Feeds

Paths under `/alerts-api/feeds`.

- [`GET /alerts-api/feeds`](/docs/rest/alerts/list-feeds): List feeds. Returns a paginated list of feeds, sorted newest first.
- [`POST /alerts-api/feeds`](/docs/rest/alerts/create-feed): Create feed. Create a new alert feed that delivers matching real estate events to your webhook URL.
- [`GET /alerts-api/feeds/{feed_id}`](/docs/rest/alerts/get-feed): Get feed. Returns the feed configuration in the same format as it was originally created.
- [`DELETE /alerts-api/feeds/{feed_id}`](/docs/rest/alerts/delete-feed): Delete feed. Permanently removes the feed.

### Webhooks

Paths under `/alerts-api/webhooks`.

- [`PUT /alerts-api/webhooks`](/docs/rest/alerts/set-webhook-url): Set webhook URL. Sets (or replaces) the delivery URL for all your alert feeds.
- [`POST /alerts-api/webhooks/rotate-secret`](/docs/rest/alerts/rotate-signing-secret): Rotate signing secret. Issues a new current signing secret.

## MCP and REST compared

Over MCP: 0 tools. Over REST: 12 operations. Available over REST only: MCP has no tool for it.

Details: [MCP and REST compared](/docs/parity#alerts).

## Questions about this

- [Which products does Casafari MCP offer, and how many tools are there?](/docs/faq/which-products)
- [Can I get alerts (new properties, price cuts, sales) over Casafari MCP?](/docs/faq/alerts-over-mcp)
- [How do I get alerts delivered to a webhook?](/docs/faq/alerts-webhook)
- [Does Casafari keep price and status history?](/docs/faq/price-and-status-history)