# Zap Imóveis Ad ## Overview | Property | Value | |----------|-------| | **Status** | active | | **Method** | `GET` | | **Endpoint** | `/v2/zapimoveis/ad` | | **Base URL** | `https://api.piloterr.com` | | **Credit Cost** | 1 credit per call | | **Documentation** | https://www.piloterr.com/library/zapimoveis-ad | ## Description Get a full Zap Imóveis listing by URL: price, IPTU, features, coordinates, images, and publisher (1 credit). ## 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/ad' \ --header 'Content-Type: application/json' \ --header 'x-api-key: YOUR_API_KEY' ``` ## Example Response ### Apartment for sale in Jardim Paulista, São Paulo ```json { "id": "2912096343", "url": "https://www.zapimoveis.com.br/imovel/venda-apartamento-3-quartos-mobiliado-jardim-paulista-zona-sul-sao-paulo-sp-170m2-id-2912096343/", "price": { "iptu": 800, "amount": 2500000, "currency": "BRL", "price_max": null, "condominium": 3300, "price_per_m2": 14706, "price_period": null }, "title": "Apartamento para comprar com 170 m², 3 quartos, 3 banheiros, 2 vagas", "images": [ "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", "https://resizedimgs.zapimoveis.com.br/img/vr-listing/606ad8b94d41ff11d250bbf21f42fac1/apartamento-com-3-quartos-a-venda-170m-no-jardim-paulista-sao-paulo.webp?action=fit-in&dimension=614x297&seo=false", "https://resizedimgs.zapimoveis.com.br/img/vr-listing/85c5f47f8f5b869e649898a0f27b06da/apartamento-com-3-quartos-a-venda-170m-no-jardim-paulista-sao-paulo.webp?action=fit-in&dimension=614x297&seo=false", "https://resizedimgs.zapimoveis.com.br/img/vr-listing/ffb439a066985fc4af7393f5af14d7a8/apartamento-com-3-quartos-a-venda-170m-no-jardim-paulista-sao-paulo.webp?action=fit-in&dimension=614x297&seo=false", "https://resizedimgs.zapimoveis.com.br/img/vr-listing/068b9d25ca605784e2913bb62ec4e713/apartamento-com-3-quartos-a-venda-170m-no-jardim-paulista-sao-paulo.webp?action=fit-in&dimension=614x297&seo=false" ], "status": "active", "features": { "floor": 9, "suites": 1, "area_m2": 170, "area_max": null, "bedrooms": 3, "amenities": [ "reception", "furnished", "safety_circuit", "service_area", "internet_access", "elevator", "intercom", "kitchen", "cable_tv", "laundry", "pets_allowed", "garden" ], "bathrooms": 3, "parking_spaces": 2, "building_floors": 10 }, "location": { "city": "São Paulo", "state": "São Paulo", "street": "Alameda Joaquim Eugênio de Lima", "latitude": -23.571, "longitude": -46.656, "state_code": "SP", "approximate": true, "full_address": "Alameda Joaquim Eugênio de Lima - Jardim Paulista, São Paulo - SP", "neighborhood": "Jardim Paulista" }, "operation": "sale", "publisher": { "id": "f6645d26-414f-98df-22b0-338e40a3d71f", "url": "https://www.zapimoveis.com.br/imobiliaria/661812/", "name": "Paulo Roberto Leardi", "tier": "diamond", "phones": [ "1132847000", "11973516994" ], "license": "13057-F-SP", "logo_url": "https://resizedimgs.zapimoveis.com.br/img/vr-listing/7ee8941c3572b44acc3d9a9ea4ce29e9/paulo-roberto-leardi.webp?action=fit-in&dimension=72x72", "verified": false, "whatsapp": "11973516994" }, "reference": "667523", "updated_at": "2026-10-01T11:33:22.061Z", "description": "Apartamento à venda no nobre e sofisticado bairro do Jardim Paulista entre a alameda Lorena e rua Guarará, parte plana, próximo ao lindo e exuberante Parque do Ibirapuera e ao diversificado comércio da região, como ao Shopping Jardim Pamplona Shopping, Pão de Açucar, Swift entre outras lojas. \nUm (1) por andar, tendo todas as faces, é um imóvel com muito sol e muita ventilação.\nAmplo com living para três (3) bons e c…", "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", "virtual_tour_url": null } ``` ### Apartment for rent in Gávea, Rio de Janeiro ```json { "id": "2908582541", "url": "https://www.zapimoveis.com.br/imovel/aluguel-apartamento-2-quartos-com-piscina-gavea-zona-sul-rio-de-janeiro-rj-71m2-id-2908582541/", "price": { "iptu": 598, "amount": 10800, "currency": "BRL", "price_max": null, "condominium": 1765, "price_per_m2": 152, "price_period": "monthly" }, "title": "Apartamento para alugar com 71 m², 2 quartos, 2 banheiros, 1 vaga", "images": [ "https://resizedimgs.zapimoveis.com.br/img/vr-listing/fe13b29d87b1a8911fd4d65545218846/apartamento-com-2-quartos-para-alugar-71m-no-gavea-rio-de-janeiro.webp?action=fit-in&dimension=614x297", "https://resizedimgs.zapimoveis.com.br/img/vr-listing/76157749ccb0c5a6eb29b82fbb3d7581/apartamento-com-2-quartos-para-alugar-71m-no-gavea-rio-de-janeiro.webp?action=fit-in&dimension=614x297&seo=false", "https://resizedimgs.zapimoveis.com.br/img/vr-listing/c335810a5a55b94b31da253592614ef7/apartamento-com-2-quartos-para-alugar-71m-no-gavea-rio-de-janeiro.webp?action=fit-in&dimension=614x297&seo=false", "https://resizedimgs.zapimoveis.com.br/img/vr-listing/7629572174a98e9d2d9c37ed203fc855/apartamento-com-2-quartos-para-alugar-71m-no-gavea-rio-de-janeiro.webp?action=fit-in&dimension=614x297&seo=false", "https://resizedimgs.zapimoveis.com.br/img/vr-listing/6daab2ccb1993f8e576d4c35f6679c55/apartamento-com-2-quartos-para-alugar-71m-no-gavea-rio-de-janeiro.webp?action=fit-in&dimension=614x297&seo=false" ], "status": "active", "features": { "floor": 0, "suites": 1, "area_m2": 71, "area_max": null, "bedrooms": 2, "amenities": [ "concierge_24h", "garage", "balcony", "kitchen_cabinets", "air_conditioning", "indoor_soccer", "party_hall", "laundry", "internet_access", "childrens_pool", "sports_court", "full_cabling", "gym", "recreation_area", "pool" ], "bathrooms": 2, "parking_spaces": 1, "building_floors": null }, "location": { "city": "Rio de Janeiro", "state": "Rio de Janeiro", "street": "Rua Marquês de São Vicente", "latitude": -22.978, "longitude": -43.233, "state_code": "RJ", "approximate": true, "full_address": "Rua Marquês de São Vicente - Gávea, Rio de Janeiro - RJ", "neighborhood": "Gávea" }, "operation": "rent", "publisher": { "id": "7ffd17dc-f1f5-90b3-5d37-77ca93fbcb5b", "url": "https://www.zapimoveis.com.br/imobiliaria/746625/", "name": "Stella Maris Real Estate", "tier": "diamond", "phones": [ "21992515265" ], "license": "8474-J-RJ", "logo_url": "https://resizedimgs.zapimoveis.com.br/img/vr-listing/450ffaf3418085cf59dcc3df631face3/stella-maris-real-estate.webp?action=fit-in&dimension=72x72", "verified": true, "whatsapp": "21992515265" }, "reference": "AP-GA-080-L", "updated_at": "2026-09-12T09:15:27.638Z", "description": "Parque Sustentável da Gávea, Apartamento novo, primeira locação, todo planejado e climatizado com varanda, 2 quartos e 1 vaga para locação em excelente localização.\n\nCom 71 m2, o imóvel é super bem dividido em: ampla sala para 2 ambientes climatizada e com acesso direto à uma varanda com bancada de apoio, 2 quartos com armários e ar condicionado sendo 1 suíte, banheiro social completo, cozinha planejada com muitos ar…", "published_at": "2021-12-02T12:49:25Z", "property_type": "apartment", "thumbnail_url": "https://resizedimgs.zapimoveis.com.br/img/vr-listing/fe13b29d87b1a8911fd4d65545218846/apartamento-com-2-quartos-para-alugar-71m-no-gavea-rio-de-janeiro.webp?action=fit-in&dimension=614x297", "virtual_tour_url": null } ``` ## Documentation ## Overview 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`. ## Quickstart ``` 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/ ``` ## Parameters | Parameter | Type | Required | Description | |---|---|---|---| | `query` | string | yes | Full Zap Imóveis listing URL (`/imovel/` or `/lancamentos/`) | ## Response fields | 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 | ## Notes - 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. ## Error codes | 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 | ## Related endpoints - [Zap Imóveis Search](https://www.piloterr.com/library/zapimoveis-search) ## Main use cases - 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