Imovelweb: Search
Search from Imovelweb as JSON. 1 credit per successful call.
GET /v1/imovelweb/search
Parameters
Send parameters in the query string.
| Parameter | Type | Required | Allowed values |
|---|---|---|---|
location | string | Optional | Any |
listing_type | string | Optional | sale, rent, auction, seasonal |
property_type | string | Optional | casa, apartamento, comercial, terreno, rural |
property_subtype | string | Optional | casa-padrao, casa-casa-de-condominio, casa-casa-de-vila, casa-sobrado, casa-quarto, apartamento-padrao, apartamento-kitchenette-studio, apartamento-loft, apartamento-flat, apartamento-cobertura, apartamento-duplex, apartamento-triplex, apartamento-quarto, apartamento-garden, comercial-box-garagem, comercial-predio-inteiro, comercial-conjunto-comercial-sala, comercial-casa-comercial, comercial-loja-de-shopping-centro-comercial, comercial-loja-salao, comercial-galpao-deposito-barracao, comercial-hotel, comercial-motel, comercial-pousada-chale, comercial-industria, comercial-area-industrial, comercial-consultorio, comercial-clinica, comercial-andar, comercial-ponto-comercial, comercial-area-comercial, rural-chacara, rural-sitio, rural-fazenda, rural-haras, terreno-terreno-padrao, terreno-loteamento-condominio |
seller_type | string | Optional | owner, company |
keyword | string | Optional | Up to 100 characters |
feature | string | Optional | Up to 500 characters |
age_min | string | Optional | under_construction, launching_soon, up_to_5_years, 5_to_10_years, 10_to_20_years, 20_to_50_years, over_50_years |
age_max | string | Optional | under_construction, launching_soon, up_to_5_years, 5_to_10_years, 10_to_20_years, 20_to_50_years, over_50_years |
published_within | string | Optional | today, since_yesterday, 7_days, 15_days, 30_days, 45_days |
development_only | boolean | Optional | Any |
sort | string | Optional | relevance, price_asc, price_desc, newest, price_drop |
page | integer | Optional | Any |
per_page | integer | Optional | Any |
bedrooms_min | integer | Optional | Any |
bedrooms_max | integer | Optional | Any |
bathrooms_min | integer | Optional | Any |
bathrooms_max | integer | Optional | Any |
garages_min | integer | Optional | Any |
garages_max | integer | Optional | Any |
price_min | integer | Optional | Any |
price_max | integer | Optional | Any |
area_min | integer | Optional | Any |
area_max | integer | Optional | Any |
covered_area_min | integer | Optional | Any |
covered_area_max | integer | Optional | Any |
Example request
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.
Run this endpoint in the playground with your own parameters. 1 credit per successful call; failed calls are free.