--- title: "Imovelweb API: Search | Perceptlayer" description: "Search from Imovelweb as JSON. 1 credit per successful call." url: https://perceptlayer.com/apis/imovelweb/search --- [APIs](https://perceptlayer.com/apis) / [Imovelweb](https://perceptlayer.com/apis/imovelweb) / Search # 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 OK JSON X-Credits-Used: 1 Recorded from our API and shortened. [Run this endpoint in the playground](https://perceptlayer.com/apis/imovelweb?try=search#playground) with your own parameters. 1 credit per successful call; failed calls are free.