# ZAP Imóveis Search

## Overview

| Property | Value |
|----------|-------|
| **Status** | private |
| **Method** | `GET` |
| **Endpoint** | `/v2/zapimoveis/search` |
| **Base URL** | `https://api.piloterr.com` |
| **Credit Cost** | 1 credit per call |
| **Documentation** | https://www.piloterr.com/library/zapimoveis-search |

## Description

Search ZAP Imóveis Brazilian real estate listings by location and get price, area, rooms, condo fee, IPTU, and agent details as structured JSON in real time.

## Authentication

- **Key Name:** `x-api-key`
- **Location:** HTTP Header
- **Get an API key:** https://app.piloterr.com/register

## Example Request

```bash
curl --location --request GET 'https://api.piloterr.com/v2/zapimoveis/search' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY'
```

## Example Response

### Search in Vila Mariana, São Paulo

```json
{
  "page": 1,
  "results": [
    {
      "id": "2859088547",
      "url": "https://www.zapimoveis.com.br/imovel/apartamento-2-quartos-vila-mariana-bairros-sao-paulo-sp-60m2-venda-id-2859088547/",
      "iptu": 97,
      "price": 730000,
      "title": "Apartamento para comprar com 84 m², 2 quartos, 2 banheiros, 1 vaga em Vila Mariana, São Paulo",
      "address": {
        "lat": -23.5865,
        "lon": -46.6388,
        "city": "São Paulo",
        "state": "SP",
        "street": "Rua Doutor Mário Cardim",
        "neighborhood": "Vila Mariana"
      },
      "bedrooms": 2,
      "bathrooms": 2,
      "condo_fee": 1445,
      "thumbnail": "https://resizedimgs.zapimoveis.com.br/fit-in/760x420/vr.images.sp/2859088547_primary.jpg",
      "agent_name": "CURY EMPREENDIMENTOS E INCORPORAÇÕES LTDA",
      "area_total": 84,
      "area_useful": 78,
      "published_at": "2026-04-01T09:00:00Z",
      "price_per_sqm": 8690,
      "property_type": "Apartamento",
      "is_highlighted": true,
      "parking_spaces": 1,
      "transaction_type": "venda"
    }
  ],
  "total_pages": 47316,
  "total_results": 946312
}
```

## Documentation

## Overview

ZAP Imóveis is one of Brazil's two largest real estate portals, part of Grupo OLX, with over 900,000 active listings. The platform uses Cloudflare to block automated access. Piloterr handles the bypass transparently. One GET request with a location query returns paginated property listings as structured JSON.

## Quickstart

```
GET https://api.piloterr.com/v2/zapimoveis/search?query=Vila+Mariana
```

## Parameters

| Parameter | Type | Required | Description |
|---|---|---|---|
| `query` | string | yes | Location: city, neighborhood, or state |
| `type` | string | no | `venda` or `aluguel` |
| `property_type` | string | no | Property type filter |
| `min_price` / `max_price` | integer | no | Price range in BRL |
| `min_rooms` | integer | no | Minimum bedrooms |
| `min_area` | integer | no | Minimum area in m² |

## Main use cases

- Build a real estate price intelligence tool tracking market value per m² by neighborhood
- Feed a property valuation model with live listing data
- Monitor new listings in a target area and alert buyers in real time
- Aggregate rental supply data for investment yield calculations
- Power a proptech platform with fresh Brazilian real estate data