Piloterr

Zap Imóveis Search

GET
/v2/zapimoveis/search

Search Zap Imóveis listings by city or search URL. Returns prices, IPTU, condominium fees, rooms, and pagination (1 credit).

Credit cost: 1 credit per call

Authorization

ApiKeyAuth
headerx-api-key<token>

Your API key. Include it in the x-api-key header for every request.

Query Parameters

query*string

City, City, UF, neighborhood, or full Zap Imóveis search URL.

Example 1 (city):

São Paulo

Example 2 (city and state):

Rio de Janeiro, RJ

Example 3 (search URL):

https://www.zapimoveis.com.br/venda/apartamentos/sp+sao-paulo/

Example 4 (page 2):

https://www.zapimoveis.com.br/venda/casas/mg+belo-horizonte/?pagina=2
operation?string

Transaction type. Used when query is a city. Ignored as a path builder when query is a full URL.

  • sale: for sale (default)
  • rent: for rent

Aliases venda, aluguel, buy, and rental are accepted. The response uses sale or rent.

Default"sale"
property_type?string

Property type. Used when query is a city.

  • apartment
  • house
  • penthouse (cobertura)
  • land
  • studio (kitnet)
  • condo
  • flat
  • loft
  • commercial / office
  • warehouse
  • store
  • farm
  • building
  • sobrado

Empty means all types (imoveis).

page?number

Page number (1-based). Default: 1. Values above 1 set pagina on the URL.

Default"1"
min_price?number

Minimum asking price in BRL.

Example:

500000
max_price?number

Maximum asking price in BRL.

Example:

2000000
min_area?number

Minimum area in m².

Example:

70
max_area?number

Maximum area in m².

Example:

150
min_bedrooms?number

Minimum bedroom count.

Example:

3
min_bathrooms?number

Minimum bathroom count.

Example:

2
min_parking?number

Minimum parking spaces.

Example:

1
fields?string

Comma-separated list of response fields to return, with dot notation for nested fields (e.g. name,location.city).

is_async?boolean

Run the request as a background job: the API answers 202 with a job_id to poll on GET /v1/jobs/{id}.

Defaultfalse
soft_fail?boolean

Return HTTP 200 even when the request fails; the error is in the error field of the body.

Defaultfalse

Response Body

Successful response

application/json
  1. response
results?array<>
pagination?
Example Request
curl -X GET 'https://api.piloterr.com/v2/zapimoveis/search?query=string'
Example Response
{  "results": [    {      "id": "2912096343",      "url": "https://www.zapimoveis.com.br/imovel/venda-apartamento-3-quartos-mobiliado-jardim-paulista-zona-sul-sao-paulo-sp-170m2-id-2912096343/",      "city": "São Paulo",      "iptu": 800,      "floor": 9,      "price": 2500000,      "state": "São Paulo",      "title": "Apartamento para comprar com 170 m², 3 quartos, 3 banheiros, 2 vagas",      "suites": 1,      "address": "Alameda Joaquim Eugênio de Lima",      "area_m2": 170,      "area_max": null,      "bedrooms": 3,      "currency": "BRL",      "latitude": -23.571,      "bathrooms": 3,      "longitude": -46.656,      "operation": "sale",      "price_max": null,      "state_code": "SP",      "condominium": 3300,      "neighborhood": "Jardim Paulista",      "price_per_m2": 14706,      "price_period": null,      "published_at": "2021-06-04T20:57:05Z",      "property_type": "apartment",      "thumbnail_url": "https://resizedimgs.zapimoveis.com.br/img/vr-listing/ab361b6c58c7374a2d3ddb8893e24c4f/apartamento-com-3-quartos-a-venda-170m-no-jardim-paulista-sao-paulo.webp?action=fit-in&dimension=614x297",      "parking_spaces": 2,      "publisher_name": "Paulo Roberto Leardi"    },    {      "id": "2856335837",      "url": "https://www.zapimoveis.com.br/lancamentos/joya-jardins-id-2856335837/",      "city": "São Paulo",      "iptu": null,      "floor": 0,      "price": 1707192,      "state": "São Paulo",      "title": "Apartamento para comprar com 57 - 153 m², 1 quarto, 1 banheiro, 1 vaga",      "suites": 1,      "address": "Rua da Consolação",      "area_m2": 57,      "area_max": 153,      "bedrooms": 1,      "currency": "BRL",      "latitude": -23.558224,      "bathrooms": 1,      "longitude": -46.665412,      "operation": "sale",      "price_max": 4740872,      "state_code": "SP",      "condominium": null,      "neighborhood": "Cerqueira César",      "price_per_m2": 29951,      "price_period": null,      "published_at": "2025-03-12T11:42:11Z",      "property_type": "apartment",      "thumbnail_url": "https://resizedimgs.zapimoveis.com.br/img/vr-listing/dab3db62b3c764fd96d0457e7fcd4431/joya-jardins-no-cerqueira-cesar-sao-paulo.webp?action=fit-in&dimension=614x297",      "parking_spaces": 1,      "publisher_name": "Bom Negocio Atividades De Internet Ltda"    }  ],  "pagination": {    "next": "https://www.zapimoveis.com.br/venda/apartamentos/sp+sao-paulo/?pagina=2",    "page": 1,    "per_page": 30,    "total_pages": 14528,    "total_results": 435826  }}