Property Sourcing · Use cases

Shared-mandate and competitor mapping for an office

For Brokerage and agency network operators. Search an office's area with Casafari, use listings_count and expand=listings to map exclusive versus shared mandates and which agencies hold them.

#Why do offices track competitors in spreadsheets?

Each office keeps its own list of competitors' properties, copied from portals and agency websites, and nobody knows which homes are advertised by one agency alone and which are shared, reduced, reserved, withdrawn or sold. A network with many agents needs one view per area.

#How does it work step by step?

1. Define the area. GET /v1/locations/search gives the office's location_ids (up to 100 per search).
2. Pull supply. POST /v1/property-sourcing/searches with those ids, operation and sort: "recently_updated"; page with GET /v1/property-sourcing/searches/{cursor}.
3. Classify. listings_count on each result says how many places advertise the home: 1 means a single place, higher values point to a shared mandate or the same home advertised more than once.
4. Identify agencies. For properties worth a closer look, GET /v1/property-sourcing/properties/{property_id}?expand=listings names the agency, URL, price and status for each place it is advertised; expand=history adds the dated price and status changes.
5. Refresh. Re-run on a schedule and compare prop_… ids and statuses, or use Alerts for feeds of new properties, price changes, reservations, withdrawals and sales.

curl -X POST https://platform.casafari.com/v1/property-sourcing/searches \
  -H "Authorization: Bearer $CASAFARI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"location_ids": [12345], "operation": "sale", "sort": "recently_updated", "page_size": 100}'

#What do you get?

A deduplicated table of the properties for sale (or for rent) in the area with their agencies, the price at each, status and time on market, built from one record per home rather than one row per advertisement. Combined with High Potential Seller Leads in Spain, France, Italy, Germany, Greece and Andorra, it also shows which of those homes keep cutting price.

#What are the limits?

Authenticate with a platform API key from the console (see Platform API keys). Guards on pay as you go and Agent are 50 distinct places a day, 20 requests a minute and 3 concurrent requests; on Free, 10 places, 10 requests a minute and 2 concurrent. A search reaches 1,000 results, so split large territories by location id. The agencies shown are those advertising the home, not a register of mandates. Reference: Get a property.

#Related use cases

• Deduplicated buyer shortlist from a plain-language brief
• Price-per-sqm value screen across European markets
• Resolve client-forwarded links to one property record
• New-supply digest for a farm area
• Property Sourcing FAQ