Get one listing from zapimoveis.com.br. Pass the full ad URL (/imovel/...-id-{id}/ or /lancamentos/...-id-{id}/). The response is a single object, not wrapped in results. 1 credit per call. Missing or unparseable ads return 404.
GET https://api.piloterr.com/v2/zapimoveis/ad?query=https://www.zapimoveis.com.br/imovel/venda-apartamento-3-quartos-mobiliado-jardim-paulista-zona-sul-sao-paulo-sp-170m2-id-2912096343/
GET https://api.piloterr.com/v2/zapimoveis/ad?query=https://www.zapimoveis.com.br/lancamentos/joya-jardins-id-2856335837/
| Parameter |
Type |
Required |
Description |
query |
string |
yes |
Full Zap Imóveis listing URL (/imovel/ or /lancamentos/) |
| Field |
Type |
Description |
id / url / title / description |
string |
Identity and copy |
reference |
string | null |
Advertiser reference (externalId) |
status |
string |
active |
operation |
string |
sale or rent |
property_type |
string |
Lowercase type, for example apartment, house, condo_house, penthouse, land |
published_at / updated_at |
string | null |
ISO 8601 |
price.amount / price_max |
number | null |
Asking price in BRL. price_max is the top of a development range. amount is null when the listing is price on request |
price.currency |
string | null |
BRL when a price is present |
price.iptu / condominium |
number | null |
Yearly IPTU and monthly condominium fee |
price.price_period |
string | null |
monthly for rent, null for sale |
price.price_per_m2 |
integer | null |
Price divided by usable area |
features.area_m2 / area_max |
number | null |
Usable area in m² |
features.bedrooms / bathrooms / suites / parking_spaces |
integer | null |
Room counts |
features.floor / building_floors |
integer | null |
Unit floor and building height |
features.amenities |
array |
Lowercase snake_case tags such as elevator, furnished, pool |
location |
object |
Street, neighborhood, city, state, state_code, full_address, coordinates, approximate |
publisher |
object |
name, url, license, phones, whatsapp, logo_url, lowercase tier, verified |
images / thumbnail_url |
array / string |
Photo URLs |
virtual_tour_url |
string | null |
Virtual tour |
- Enum values are lowercase:
operation, property_type, status, price.price_period, features.amenities, publisher.tier. Currency stays BRL.
- Street, neighborhood, city, title, description, and publisher name keep their original casing.
- Tracking query parameters on the URL are stripped.
| Code |
Meaning |
400 |
Empty query, or a URL that is not a Zap Imóveis /imovel/ or /lancamentos/ ad |
404 |
Listing not found, or the HTML is not a listing |
500 |
Fetch or parse failed |
- Pull IPTU, condominium, and price per m² for a known Zap listing
- Collect photos, amenities, and publisher contact from sale and rent ads
- Open development pages (
/lancamentos/) that search cards link to
