# Chaves na Mao Brazil Property and Vehicle Listings API

> Chaves na Mão: Brazilian homes for sale and rent, used and new cars and motorbikes, and FIPE prices

- Vendor: `chavesnamaobrazilpropertyandve` · version 1.0 · category Listings · tags brazil real estate api, imoveis api, brazil property listings api, brazil car listings api, fipe api, used cars brazil api, chaves na mao api
- Datasource: custom HTTP routes
- Marketplace page: https://apiclay.com/api/chavesnamaobrazilpropertyandve
- This document: https://apiclay.com/docs/chavesnamaobrazilpropertyandve.md
- OpenAPI 3.1: https://apiclay.com/api/chavesnamaobrazilpropertyandve/openapi.json
- MCP: connect https://api.apiclay.com/v1/mcp (see https://apiclay.com/llms.txt), then `apiclay_describe_api` with vendor `chavesnamaobrazilpropertyandve`
- Updated: 2026-11-18

## About

## Chaves na Mao Brazil Property and Vehicle Listings API

Search the listings of Chaves na Mão, one of Brazil's large classifieds sites for property and vehicles, through the site's own public MCP server: homes, flats, land and commercial property for sale, rent or off-plan by city, state, neighbourhood, street, bedrooms, bathrooms, parking, price, area and amenities; cars and motorbikes by brand, model, year, price, mileage, fuel, transmission, colour, body type and options; and vehicle price intelligence with the FIPE table range, the market price range of current ads per version and similar offers. Each listing has its id, title, price in BRL, location, key specs, image and canonical ad URL.

Data comes from **chavesnamao.com.br** (https://www.chavesnamao.com.br). Every route calls the source's own public API and returns it unchanged.

Typical flow: `POST /properties` with the body `{"params": {"name": "search_realty_listings", "arguments": {"filters": {"transaction": "aluguel", "city": "Curitiba", "state": "PR"}, "pageSize": 15}}}`; `POST /tools` returns every tool's full argument schema.

### Routes

#### POST `/properties` - Properties
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| params | body | object | yes | `{"name": "search_realty_listings", "arguments": {...}}`. Arguments: `filters` (`transaction` `venda`, `aluguel` or `lancamentos`; `propertyType` e.g. `apartamento`, `casa`, `terreno`, `sala comercial`; `city`; `state` (2-letter UF, e.g. `PR`); `neighborhood`; `street`; `bedrooms`; `bathrooms`; `parkingSpots`; `minPrice`; `maxPrice`; `minArea`; `maxArea`; `amenities` e.g. `["piscina"]`), `query` (free text in Portuguese, used when there are no filters), `proximity` (`{"target": "Parque Barigui"}` for listings near a landmark), `page` (from 1) and `pageSize` (`15`). |

Returns: JSON-RPC `result`: `structuredContent` (the data as an object) and `content[0].text` (the same as a JSON string). `results` (`id`, `title`, `url`, `transaction`, `propertyType`, `priceBRL`, `location` (`city`, `state`, `neighborhood`), `bedrooms`, `bathrooms`, `parkingSpots`, `areaM2`, `imageUrl`), `pagination`, `appliedFilters`, `searchUrl`.

#### POST `/vehicles` - Vehicles
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| params | body | object | yes | `{"name": "search_vehicle_listings", "arguments": {...}}`. Arguments: `filters` (`vehicleCategory` `carro` or `moto`; `condition` `novo`, `usado`, `seminovo`; `bodyType` e.g. `suv`, `sedan`, `hatch`, `picape`; `brand`; `model`; `minYear`; `maxYear`; `minPrice`; `maxPrice`; `maxKm`; `fuel`; `transmission`; `color`; `city`; `state`; `optionals` e.g. `["teto solar"]`), `query` (free text), `page` (1 to 20) and `pageSize` (`15`). |

Returns: JSON-RPC `result`: `structuredContent` (the data as an object) and `content[0].text` (the same as a JSON string). `results` (`id`, `title`, `url`, `brand`, `model`, `version`, `year`, `kmDriven`, `priceBRL`, `fuel`, `transmission`, `color`, `location`, `imageUrl`), `pagination`, `appliedFilters`, `searchUrl`.

#### POST `/vehicle-prices` - Vehicle prices
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| params | body | object | yes | `{"name": "vehicle_price_intelligence", "arguments": {...}}`. Arguments: `query` (e.g. `valor de mercado Ford Ecosport 2021`), or `filters` (`category`, `brand`, `model`, `version`, `year`, `city`, `state`), and `maxOffers` (1 to 10). |

Returns: JSON-RPC `result`: `structuredContent` (the data as an object) and `content[0].text` (the same as a JSON string). `vehicle` (as understood), `priceSummary`: `fipe` (FIPE table range for the year, update month, version count), `market` (sample size and price range of current ads, with median, low and high per version) and `listingSample`; `similarOffers` (ads like `/vehicles` results) and `links`.

#### POST `/tools` - Tools
No parameters.

Returns: JSON-RPC `result.tools`: each tool's `name`, `description` (Portuguese) and full `inputSchema`.

### Caveats

- Tool names and arguments follow the site's MCP server; send arguments in Portuguese as in the examples. A call with invalid arguments returns a JSON-RPC `error` with the failing field.
- Ad `url`, `cta.url` and `searchUrl` can come as paths: prefix `https://www.chavesnamao.com.br`. A relative `imageUrl` goes under `https://www.chavesnamao.com.br/imn/0100x0070/N/75/imoveis/` (or `.../veiculos/`). `_meta.presentationHint` holds the site's display hints for AI assistants.
- Listings are third-party ads; prices and availability change daily.
- Upstream responses can change over time. Verify fields before relying on them.
- Not affiliated with or endorsed by chavesnamao.com.br.

## Pricing

- Pay as you go: 0.0012 credits/request
- Trial: 1 free requests per buyer
- Billing order: trial requests -> subscribed plan requests -> pay as you go. 1 credit's USD value is shown on the marketplace page.

## HTTP routes

Only the public, buyer-facing parts of each route are listed; vendor-side credentials stay on the gateway.

### POST /properties — Properties
- Gateway: `POST https://api.apiclay.com/v1/api/chavesnamaobrazilpropertyandve/properties`
- Body sample (JSON):

```json
{"params": {"name": "search_realty_listings", "arguments": {"filters": {"transaction": "aluguel", "propertyType": "apartamento", "city": "Curitiba", "state": "PR", "bedrooms": 2}, "page": 1, "pageSize": 15}}}
```

- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### POST /vehicles — Vehicles
- Gateway: `POST https://api.apiclay.com/v1/api/chavesnamaobrazilpropertyandve/vehicles`
- Body sample (JSON):

```json
{"params": {"name": "search_vehicle_listings", "arguments": {"filters": {"brand": "Honda", "model": "Civic", "maxPrice": 90000}, "page": 1}}}
```

- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### POST /vehicle-prices — Vehicle prices
- Gateway: `POST https://api.apiclay.com/v1/api/chavesnamaobrazilpropertyandve/vehicle-prices`
- Body sample (JSON):

```json
{"params": {"name": "vehicle_price_intelligence", "arguments": {"query": "valor de mercado Ford Ecosport 2021"}}}
```

- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### POST /tools — Tools
- Gateway: `POST https://api.apiclay.com/v1/api/chavesnamaobrazilpropertyandve/tools`
- Body sample (JSON):

```json
{}
```

- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

## Call example

```bash
curl -X POST "https://api.apiclay.com/v1/api/chavesnamaobrazilpropertyandve/properties" \
  -H "token: <YOUR_APICLAY_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"params": {"name": "search_realty_listings", "arguments": {"filters": {"transaction": "aluguel", "propertyType": "apartamento", "city": "Curitiba", "state": "PR", "bedrooms": 2}, "page": 1, "pageSize": 15}}}'
```

Index of every published API: https://apiclay.com/llms.txt
