Value and compare · Use case

How do I turn comparables into a client-ready CMA report?

To turn comparables into a client-ready CMA report, run comps_get-comparables (Comparables & Valuation) and keep its casafari_link, which opens the Comparative Market Analysis page, and its valuation_id. Casafari client accounts can then start an AI Builder session with POST /api/v2/comparables/ai-builder and share chosen comparables with POST /api/v1/properties/smart-links (BETA).

Products: Comparables & Valuation, Property Sourcing

#Short answer

The valuation call already returns casafari_link, a link to the Comparative Market Analysis page, and valuation_id, a persistent ID that the field description says is used to generate a Smart Link or a PDF. Over REST, Casafari client accounts turn the valuation_id into an AI Builder session showing the agent's details, and share selected comparables with a smart link.

#Steps

#Run comps_get-comparables and keep casafari_link and valuation_id

1. Call list_servers, then comps_get-comparables with comparables_count, location_boundary, operation and comparables_types. Store casafari_link, valuation_id, and the primary_listing_id of each comparable you may want to show.

#Start an AI Builder session with POST /api/v2/comparables/ai-builder (valuation_id, agent, language, external_ref)

2. Sign in to the REST API at https://api.casafari.com with POST /login and send the access token as a bearer token.
3. Call POST /api/v2/comparables/ai-builder with valuation_id (the ID of the saved CMA to build the session from), agent (agent data to display in the Builder), language (the session's language) and external_ref. The operation page documents each field's exact format.

#Create a smart link with POST /api/v1/properties/smart-links from primary_listing_id values of the comparables you want to show

4. Call POST /api/v1/properties/smart-links with primary_listing_ids set to the primary_listing_id values you chose. The operation also takes settings, user and company, documented on its page.

#Example

An agent asks their assistant: "Value my client's 3-bedroom flat near Avenida da Liberdade, Lisbon, using comparables within 1 km, and give me the CMA link." The assistant calls list_servers and comps_get-comparables, quotes the fair market price with its range, and returns casafari_link and valuation_id.

The agency's application, signed in over REST, then starts the AI Builder session:

{
  "valuation_id": "<valuation_id from comps_get-comparables>",
  "language": "<session language>",
  "external_ref": "<your CRM reference>"
}

and creates a smart link for the comparables worth showing the seller:

{
  "primary_listing_ids": ["<primary_listing_id>", "<primary_listing_id>"]
}

The shape of each response is documented on the operation pages.

#How to read the result

#valuation_id is persistent and expires in a year

Store it with the client record: within a year you can build the AI Builder session from it without re-running the valuation. After that, run a new valuation.

#Which comparables to include: similarity_score and is_outlier

Show the seller the comparables with the highest similarity_score (0 to 1), a short distance, and is_outlier false. sale_price_last_change and sale_status help explain the story: a property that cut its price, or one already sold, is persuasive evidence. Each comparable is one property in Casafari's deduplicated graph, so the same home never appears twice.

#Limits

comps_get-comparables is available to Casafari clients with MCP access, using their Casafari account; self-serve access for new users is coming soon. POST /api/v2/comparables/ai-builder and POST /api/v1/properties/smart-links are REST operations for Casafari client accounts; Property Sourcing as a whole is REST only. Prices, quotas and rate limits are not published in these docs; ask Casafari. More examples: How do I value a home or find comparables?

#The smart link operation is marked BETA

Its name is "Create a smart link (BETA)"; plan for changes to its behaviour.

#AI Builder and smart links are REST only, not MCP

An AI assistant connected to the Casafari MCP server can produce the valuation and the casafari_link, but not the AI Builder session or the smart link. MCP vs REST API lists what exists where.

#Questions

All use cases