# Embed the Search Box with a Publishable Key

> **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).

**For Proptech Vendor.** Embed the search box using pub_ keys and the embed endpoints, providing a limited-scope search experience for your end users.

> How do I embed a search interface for my users?

MCP tool: `search_premises` (REST: POST /v1/embed/search)

## The Problem
Providing a user-facing search tool on your own platform without exposing your main API key.

## How it works
1. Use a `pub_` key issued for your specific origins.
2. Call the `/v1/embed/search` endpoint to display results.

## Example
```json
POST https://platform.casafari.com/v1/claro/embed/search
{
  "key": "pub_example_key",
  "criteria": {"cities": ["madrid"]}
}
```

## What you get
A search interface limited to 50 results per page.

## Limits
`pub_` keys are restricted to the embed endpoints and specific origins.

## Related use cases

- [Score Premises with Your Own Agent](https://developers.casafari.com/docs/claro/use-cases/autonomous-scoring)
- [Nightly Pipeline into a CRM or BI](https://developers.casafari.com/docs/claro/use-cases/nightly-crm-pipeline)
- [Explain Any Point for Premises Found Elsewhere](https://developers.casafari.com/docs/claro/use-cases/explain-point)
- [Keyword Search from a Simple Form](https://developers.casafari.com/docs/claro/use-cases/keyword-form)
- [Claro AI FAQ](https://developers.casafari.com/docs/claro/faq)
