# How do I make my first call to the Casafari REST API?

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

Get a credential and send it: Casafari clients log in to the Casafari REST API for a JWT; new users send an API key from the self-serve platform.

**If you're a Casafari client:** use your existing login.

1. Send `POST https://api.casafari.com/login` with your `email` and `password` as JSON ([Login](https://developers.casafari.com/docs/rest/authentication/login)).
2. Send the returned `access_token` as `Authorization: Bearer <access_token>` to any operation your account covers.

The operations are described in [REST API](https://developers.casafari.com/docs/rest).

**If you're new to Casafari:** use an API key.

1. Create a key (`cf_sk_…`) in the [console](https://platform.casafari.com/console); it is shown once ([creating a key](https://developers.casafari.com/docs/faq/create-api-key)).
2. Call [`GET https://platform.casafari.com/v1/locations/search?query=Lisbon`](https://platform.casafari.com/v1/locations/search?query=Lisbon) with the key in the `X-API-Key` header, or as `Authorization: Bearer <api_key>`. Place lookups cost 0 units, so this first call is free.

Never put the key in a URL. For other products and operations, see the [base URL](https://developers.casafari.com/docs/faq/rest-base-url) and the [OpenAPI specs](https://developers.casafari.com/docs/faq/openapi-per-product).

## Where this is documented

- [Login](https://developers.casafari.com/docs/rest/authentication/login)
- [REST API: a real estate API for AI agents and apps](https://developers.casafari.com/docs/rest)

## Related questions

- [How do I connect Casafari MCP to Claude?](https://developers.casafari.com/docs/faq/connect-claude)
- [How do I connect Casafari MCP to ChatGPT?](https://developers.casafari.com/docs/faq/connect-chatgpt)
- [How do I add Casafari MCP to Claude Code?](https://developers.casafari.com/docs/faq/connect-claude-code)
- [How do I add Casafari MCP to Cursor?](https://developers.casafari.com/docs/faq/connect-cursor)
- [How do I add Casafari MCP to VS Code?](https://developers.casafari.com/docs/faq/connect-vscode)

All questions: https://developers.casafari.com/docs/faq#first-rest-call