Sign inGet a free API keyDashboard
Menu

APIs / Real estate / Imovelweb

1 credit per call6 endpoints21 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 keyRun 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 OKJSONX-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.

#idstringtitlestringurlurllisting_typestringposting_typestringproperty_typestringproperty_subtypestringpriceobjectpricesobjectcurrencystringdescriptionstringaddressobjectfeaturesobjectamenitiesobject[]unit_rangesobjectpicturesstring[]publisherobjectpublished_atstringfirst_online_atstringinternal_codestringhas_whatsappboolean
13049921446Apartamento à venda - em Pinheiroshttps://www.imovelweb.com.br/propriedades/apartamento-a-venda-em-pinheiros-3049921446.htmlsalepropertyApartamentoPadrão{4 fields}{1 fields}BRLApartamento 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:48Z2026-10-29T04:00:00ZROBVERVtrue
23040487028Imoveis - no Sumarezinhohttps://www.imovelweb.com.br/propriedades/imoveis-no-sumarezinho-3040487028.htmlsalepropertyApartamentoPadrão{4 fields}{1 fields}BRLApartamento à 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:42Z2026-07-17T04:00:00Z809331true
33040487142Imoveis - no Sumarezinhohttps://www.imovelweb.com.br/propriedades/imoveis-no-sumarezinho-3040487142.htmlsalepropertyApartamentoPadrão{4 fields}{1 fields}BRLLocalizado 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:14Z2026-07-17T04:00:00Z809331false

Recorded from our API · 3 items shown · 21 datapoints per itemGET /v1/imovelweb/search?location=V1-Z-52&listing_type=sale&sort=price_asc&bedrooms_min=2

21 datapoints

Identity

  • idstring
  • titlestring
  • listing_typestring
  • posting_typestring
  • property_typestring
  • property_subtypestring

Contact

  • urlurl

Location

  • addressobject

Price

  • priceobject
  • pricesobject
  • currencystring

Other

  • descriptionstring
  • featuresobject
  • amenitiesobject[]
  • unit_rangesobject
  • picturesstring[]
  • publisherobject
  • published_atstring
  • first_online_atstring
  • internal_codestring
  • has_whatsappboolean

Playground

Run this API

cURLshell
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.

EndpointRequired parametersCost
GET/v1/imovelweb/autocomplete
query+1 optional
1 credit
GET/v1/imovelweb/development
id
1 credit
GET/v1/imovelweb/listing
id
1 credit
GET/v1/imovelweb/polygon
location
1 credit
GET/v1/imovelweb/search
none+26 optional
1 credit
GET/v1/imovelweb/similar
id
1 credit

Overview

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 estateJSONRESTMCP

More real estate APIs

28Hse4zida59199.co99acresAdondevivirApartment ListApartments.comAqarAqarmapArgenpropathome

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 keyRead the docs