--- title: "Imovelweb API: JSON data, 6 endpoints, 1 credit per call" description: "Imovelweb API for Brazilian property search, listings, developments, similar listings and location polygons as JSON. 1 credit per successful call." url: https://perceptlayer.com/apis/imovelweb --- [APIs](https://perceptlayer.com/apis) / [Real estate](https://perceptlayer.com/verticals/real-estate) / Imovelweb 1 credit per call 6 endpoints 21 datapoints # Imovelweb API Imovelweb API for Brazilian property search, listings, developments, similar listings and location polygons as JSON. 1 credit per successful call. [Get a free API key](https://perceptlayer.com/signup) Run it below Imovelweb GET /v1/imovelweb/search?location=V1-Z-52&listing\_type=sale&sort=price\_asc&bedrooms\_min=2 ``` { "success": true, "data": { "applied_filters": { "listing_type": "sale", "sort": "price_asc", "location": "V1-Z-52", "bedrooms_min": "2" }, "pagination": { "page": 1, "per_page": 20, "offset": 0, "returned": 20, "duplicates_removed": 0, "total_reported": 31964, "max_offset": 10000, "has_next_page": true }, "items": [ { "id": "3049921446", "title": "Apartamento à venda - em Pinheiros", "url": "https://www.imovelweb.com.br/propriedades/apartamento-a-venda-em-pinheiros-3049921446.html", "listing_type": "sale", "posting_type": "property", "property_type": "Apartamento", "property_subtype": "Padrão", "price": { "amount": 8000, "currency": "BRL", "formatted": "R$ 8.000", "starting_from": false }, "prices": { "sale": { "amount": 8000, "currency": "BRL", "formatted": "R$ 8.000", "starting_from": false } }, "currency": "BRL", "description": "Apartamento moderno para locação no Condomínio Verve Pinheiros, localizado em um dos endereços mais valorizados de São Paulo.\n\nCom 71m², o imóvel poss", "address": { "text": "Rua dos Pinheiros, Pinheiros, São Paulo, São Paulo", "visibility": "EXACT", "postal_code": "05422-012" }, "features": { "bedrooms": 2, "suites": 0, "total_area": { "value": 71, "unit": "m2" } }, "amenities": [ { "category": "Outros", "name": "Andares" }, { "category": "Áreas Comuns", "name": "Fitness/Sala de Ginástica" }, { "category": "Áreas Comuns", "name": "Piscina" } ], "unit_ranges": { "bedrooms": "2 dorm.", "total_area": "71 m2" }, "pictures": [ "https://imgbr.imovelwebcdn.com/avisos/2/30/49/92/14/46/720x532/7461766200.jpg", "https://imgbr.imovelwebcdn.com/avisos/2/30/49/92/14/46/720x532/7461765057.jpg", "https://imgbr.imovelwebcdn.com/avisos/2/30/49/92/14/46/720x532/7461764653.jpg" ], "publisher": { "id": "47883720", "license": "16.990 J", "is_premier": false, "logo": "https://imgbr.imovelwebcdn.com/empresas/2/00/47/88/37/20/720x532/logo_nextap-imoveis_1793729149111.jpg" }, "published_at": "2026-11-04T19:38:48Z", "first_online_at": "2026-10-29T04:00:00Z", "internal_code": "ROBVERV", "has_whatsapp": true }, { "id": "3040487028", "title": "Imoveis - no Sumarezinho", "url": "https://www.imovelweb.com.br/propriedades/imoveis-no-sumarezinho-3040487028.html", "listing_type": "sale", "posting_type": "property", "property_type": "Apartamento", "property_subtype": "Padrão", "price": { "amount": 12328, "currency": "BRL", "formatted": "R$ 12.328", "starting_from": false }, "prices": { "sale": { "amount": 12328, "currency": "BRL", "formatted": "R$ 12.328", "starting_from": false } }, "currency": "BRL", "description": "Apartamento à venda na região Sumarezinho - São Paulo - SP. 2 dormitórios, 1 suítes, 1 vagas de garagem, área útil de 74 m², área total de 500 m². Car", "address": { "text": "R PAULISTÂNIA, Sumarezinho, São Paulo, São Paulo", "visibility": "EXACT", "postal_code": "05440000" }, "geo": { "latitude": -23.5476959, "longitude": -46.6907959 }, "features": { "bedrooms": 2, "bathrooms": 2, "suites": 1, "garages": 1, "age_years": 1, "condominium_fee": 1000, "total_area": { "value": 500, "unit": "m2" }, "covered_area": { "value": 74, "unit": "m2" } }, "amenities": [ { "category": "Áreas Comuns", "name": "Churrasqueira" }, { "category": "Áreas Comuns", "name": "Fitness/Sala de Ginástica" }, { "category": "Áreas Privativas", "name": "Ar condicionado" } ], "unit_ranges": { "bedrooms": "2 dorm.", "bathrooms": "2 ban.", "garages": "1 vaga", "total_area": "500 m2" }, "pictures": [ "https://imgbr.imovelwebcdn.com/avisos/2/30/40/48/70/28/720x532/6953864615.jpg", "https://imgbr.imovelwebcdn.com/avisos/2/30/40/48/70/28/720x532/6953864165.jpg", "https://imgbr.imovelwebcdn.com/avisos/2/30/40/48/70/28/720x532/6953864121.jpg" ], "publisher": { "id": "47852853", "license": ".", "is_premier": false, "logo": "https://imgbr.imovelwebcdn.com/empresas/2/00/47/85/28/53/720x532/logo_pool-imoveis-guru_1769804567172.jpg" }, "published_at": "2026-08-21T03:58:42Z", "first_online_at": "2026-07-17T04:00:00Z", "internal_code": "809331", "has_whatsapp": true }, { "id": "3040487142", "title": "Imoveis - no Sumarezinho", "url": "https://www.imovelweb.com.br/propriedades/imoveis-no-sumarezinho-3040487142.html", "listing_type": "sale", "posting_type": "property", "property_type": "Apartamento", "property_subtype": "Padrão", "price": { "amount": 12328, "currency": "BRL", "formatted": "R$ 12.328", "starting_from": false }, "prices": { "sale": { "amount": 12328, "currency": "BRL", "formatted": "R$ 12.328", "starting_from": false } }, "currency": "BRL", "description": "Localizado no ponto mais alto da Vila Madalena, nas ruas mais charmosas e arborizadas da região: Paulistânia e Senador César Lacerda Vergueiro. Um pro", "address": { "text": "R PAULISTÂNIA, Sumarezinho, São Paulo, São Paulo", "visibility": "EXACT", "postal_code": "05440000" }, "geo": { "latitude": -23.5476959, "longitude": -46.6907959 }, "features": { "bedrooms": 2, "bathrooms": 2, "suites": 1, "garages": 1, "age_years": 1, "condominium_fee": 1000, "total_area": { "value": 500, "unit": "m2" }, "covered_area": { "value": 74, "unit": "m2" } }, "amenities": [ { "category": "Áreas Comuns", "name": "Churrasqueira" }, { "category": "Áreas Comuns", "name": "Fitness/Sala de Ginástica" }, { "category": "Áreas Privativas", "name": "Ar condicionado" } ], "unit_ranges": { "bedrooms": "2 dorm.", "bathrooms": "2 ban.", "garages": "1 vaga", "total_area": "500 m2" }, "pictures": [ "https://imgbr.imovelwebcdn.com/avisos/2/30/40/48/71/42/720x532/6953867089.jpg", "https://imgbr.imovelwebcdn.com/avisos/2/30/40/48/71/42/720x532/6953866724.jpg", "https://imgbr.imovelwebcdn.com/avisos/2/30/40/48/71/42/720x532/6953866795.jpg" ], "publisher": { "id": "47392357", "license": "111", "is_premier": false, "logo": "https://imgbr.imovelwebcdn.com/empresas/2/00/47/39/23/57/720x532/logo_leardi-pompeia-268_1617801681630.jpg" }, "published_at": "2026-08-21T03:59:14Z", "first_online_at": "2026-07-17T04:00:00Z", "internal_code": "809331", "has_whatsapp": false } ] }, "meta": { "endpoint_family": "search", "request_id": "req_73d19825a8994f44ac7f15f75bd89465", "credits_charged": 1, "credits_remaining": 1856 } } ``` 200 OK JSON X-Credits-Used: 1 Recorded from our API and shortened. Sample data ## What one call returns A recorded run of `search`: the fields and shapes you will get, shortened to 3 items. | # | id string | title string | url url | listing\_type string | posting\_type string | property\_type string | property\_subtype string | price object | prices object | currency string | description string | address object | features object | amenities object\[\] | unit\_ranges object | pictures string\[\] | publisher object | published\_at string | first\_online\_at string | internal\_code string | has\_whatsapp boolean | | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | 1 | 3049921446 | Apartamento à venda - em Pinheiros | https://www.imovelweb.com.br/propriedades/apartamento-a-venda-em-pinheiros-3049921446.html | sale | property | Apartamento | Padrão | {4 fields} | {1 fields} | BRL | Apartamento moderno para locação no Condomínio Verve Pinheiros, localizado em um dos endereços mais valorizados de São Paulo. Com 71m², o imóvel poss | {3 fields} | {3 fields} | \[3 items\] | {2 fields} | \[3 items\] | {4 fields} | 2026-11-04T19:38:48Z | 2026-10-29T04:00:00Z | ROBVERV | true | | 2 | 3040487028 | Imoveis - no Sumarezinho | https://www.imovelweb.com.br/propriedades/imoveis-no-sumarezinho-3040487028.html | sale | property | Apartamento | Padrão | {4 fields} | {1 fields} | BRL | Apartamento à venda na região Sumarezinho - São Paulo - SP. 2 dormitórios, 1 suítes, 1 vagas de garagem, área útil de 74 m², área total de 500 m². Car | {3 fields} | {8 fields} | \[3 items\] | {4 fields} | \[3 items\] | {4 fields} | 2026-08-21T03:58:42Z | 2026-07-17T04:00:00Z | 809331 | true | | 3 | 3040487142 | Imoveis - no Sumarezinho | https://www.imovelweb.com.br/propriedades/imoveis-no-sumarezinho-3040487142.html | sale | property | Apartamento | Padrão | {4 fields} | {1 fields} | BRL | Localizado no ponto mais alto da Vila Madalena, nas ruas mais charmosas e arborizadas da região: Paulistânia e Senador César Lacerda Vergueiro. Um pro | {3 fields} | {8 fields} | \[3 items\] | {4 fields} | \[3 items\] | {4 fields} | 2026-08-21T03:59:14Z | 2026-07-17T04:00:00Z | 809331 | false | Recorded from our API · 3 items shown · 21 datapoints per item GET /v1/imovelweb/search?location=V1-Z-52&listing\_type=sale&sort=price\_asc&bedrooms\_min=2 21 datapoints ### Identity - id string - title string - listing\_type string - posting\_type string - property\_type string - property\_subtype string ### Contact - url url ### Location - address object ### Price - price object - prices object - currency string ### Other - description string - features object - amenities object\[\] - unit\_ranges object - pictures string\[\] - publisher object - published\_at string - first\_online\_at string - internal\_code string - has\_whatsapp boolean Playground ## Run this API cURL shell ``` curl "https://api.perceptlayer.com/v1/imovelweb/search?location=V1-Z-52&listing_type=sale&sort=price_asc&bedrooms_min=2" \ -H "X-API-Key: $API_KEY" ``` Imovelweb · 6 endpoints ## Endpoints Every endpoint takes the same key. Open one for its parameters and an example request. | Endpoint | Required parameters | Cost | | --- | --- | --- | | [GET `/v1/imovelweb/autocomplete`](https://perceptlayer.com/apis/imovelweb/autocomplete) | `query` +1 optional | 1 credit | | [GET `/v1/imovelweb/development`](https://perceptlayer.com/apis/imovelweb/development) | `id` | 1 credit | | [GET `/v1/imovelweb/listing`](https://perceptlayer.com/apis/imovelweb/listing) | `id` | 1 credit | | [GET `/v1/imovelweb/polygon`](https://perceptlayer.com/apis/imovelweb/polygon) | `location` | 1 credit | | [GET `/v1/imovelweb/search`](https://perceptlayer.com/apis/imovelweb/search) | none +26 optional | 1 credit | | [GET `/v1/imovelweb/similar`](https://perceptlayer.com/apis/imovelweb/similar) | `id` | 1 credit | Overview ## About the Imovelweb API ## What you can get The Imovelweb API returns Imovelweb property data as JSON through 6 endpoints. - **Search:** `search` takes a `location`, with `listing_type` (sale, rent, auction or seasonal), `property_type` (casa, apartamento, comercial, terreno or rural), `property_subtype` (apartamento-padrao, apartamento-cobertura, casa-casa-de-condominio, comercial-loja-salao and more), `seller_type` (owner or company), `keyword`, `feature`, `age_min` and `age_max` (under\_construction to over\_50\_years), `published_within` (today, since\_yesterday, 7\_days, 15\_days, 30\_days or 45\_days), `development_only`, `sort` (relevance, price\_asc, price\_desc, newest or price\_drop), `page`, `per_page`, and min and max filters for bedrooms, bathrooms, garages, price, area and covered area. - **Listings:** `listing` and `similar` take an `id`. - **Developments:** `development` takes an `id`. - **Locations:** `autocomplete` takes a `query`, with `limit`; `polygon` takes a `location`. The recorded `search` for location `V1-Z-52` (sale, at least 2 bedrooms, sorted by `price_asc`) returns `items`, each with `id`, `title`, `url`, `listing_type`, `posting_type`, `property_type`, `property_subtype`, `price`, `prices`, `currency`, `description`, `address`, `features`, `amenities`, `pictures`, `publisher` and `published_at`. Its `pagination` reports a `total_reported` of 31,964, with `per_page`, `max_offset` (10,000) and `has_next_page`. ## How a call works Search a location: `GET /v1/imovelweb/search?location=V1-Z-52&listing_type=sale&sort=price_asc&bedrooms_min=2` with your key in the `X-API-Key` header. Each item's `id` is what `listing` and `similar` take, and the same location code goes to `polygon`. Every successful call costs 1 credit; failed calls cost nothing. Real estate JSON REST MCP ### More real estate APIs [28Hse](https://perceptlayer.com/apis/28hse) [4zida](https://perceptlayer.com/apis/4zida) [591](https://perceptlayer.com/apis/591-house) [99.co](https://perceptlayer.com/apis/99co) [99acres](https://perceptlayer.com/apis/99acres) [Adondevivir](https://perceptlayer.com/apis/adondevivir) [Apartment List](https://perceptlayer.com/apis/apartment-list) [Apartments.com](https://perceptlayer.com/apis/apartments-com) [Aqar](https://perceptlayer.com/apis/aqar) [Aqarmap](https://perceptlayer.com/apis/aqarmap) [Argenprop](https://perceptlayer.com/apis/argenprop) [athome](https://perceptlayer.com/apis/athome) Use cases ### Track asking prices for apartments and houses in a Brazilian city or neighbourhood `Use the Imovelweb API to track asking prices for apartments and houses in a Brazilian city or neighbourhood` ### Watch price drops with \`sort=price\_drop\` `` Use the Imovelweb API to watch price drops with `sort=price_drop` `` ### Follow new launches and buildings under construction with \`development\_only\` and \`development\` `` Use the Imovelweb API to follow new launches and buildings under construction with `development_only` and `development` `` ### Find comparables for a listing with \`similar\` `` Use the Imovelweb API to find comparables for a listing with `similar` `` FAQ ## Questions **How much does the Imovelweb API cost?** Each successful call costs one credit. New accounts get free credits to start, and credit packs bring the price down as you scale. **What format are responses in?** Every endpoint returns JSON, with no HTML parsing on your side. **Do I need an Imovelweb account?** No. You call this Imovelweb API with your Perceptlayer key in the \`X-API-Key\` header, with no Imovelweb login. **How deep can one search go?** The recorded search reports 31,964 matches and a \`max\_offset\` of 10,000. Narrow the location, price or property type to reach the rest. **Should I build an Imovelweb scraper instead?** You can, but an Imovelweb scraper is code you maintain: page changes break it, requests get blocked, and Imovelweb's terms govern how you collect data. The Imovelweb API gives you 6 endpoints of named JSON fields for 1 credit per successful call, and failed calls cost nothing. A scraper makes sense only for data these endpoints don't return, so check the response in the playground on this page first. ## Try the Imovelweb API with 100 free credits No credit card. Failed calls are never billed. [Get a free API key](https://perceptlayer.com/signup) [Read the docs](https://docs.perceptlayer.com)