Imovelweb Search API lists Brazilian properties for sale, for rent, at auction or for seasonal rent. Find a location id with the autocomplete route, then add price, room, area, type, seller, age, keyword and amenity filters. Every item has the price of the requested listing type (a listing can carry a sale and a rent price, and prices holds both), the address with coordinates and postal code, bedrooms, bathrooms, suites, parking, condominium fee, total and covered area, amenities, photos, the publisher with licence number, publication dates and tags.
Good to know:
- Brazil only. Prices are in BRL. Developments (
posting_typeisdevelopment) show a starting price and ranges inunit_rangesinstead of single room counts. Numeric filters apply to their units, so a development can differ from one filter value. - Every filter is checked against what Imovelweb honours. A filter that cannot be honoured is rejected, never silently ignored.
- Results are reachable up to position 10,000. A larger page returns 422 without charge: narrow your filters.
total_reportedcomes from Imovelweb and can be higher than the real count. - Imovelweb ranks paid listing tiers together. With
price_ascorprice_desceach page is sorted by the price of the requested listing type, but the order across pages follows the tiers. - The last page of a result can repeat cards of the page before. Scrappa removes them and reports
duplicates_removed. - There is no agency endpoint. Agency data is the
publisherblock of each item and of the listing detail. - There is no coordinate radius or street text search. Use location ids and the polygon route.
- Failed requests are not billed. An empty result is a valid answer and is billed.
Run this endpoint
Endpoint
Parameters
Start with the required fields, then add optional filters only when your use case needs them.
Runnable path
This endpoint has no required query parameters.
26 optional filters available.
string
Optional
One or more location ids from the autocomplete route, comma separated, up to 10. Example: V1-Z-52. Leave empty to search all of Brazil.
Austin, Texas
string
Optional
sale (default), rent, auction or seasonal.
example
string
Optional
casa, apartamento, comercial, terreno or rural.
example
string
Optional
Subtype of the property type, such as apartamento-cobertura, apartamento-kitchenette-studio, casa-sobrado or comercial-loja-salao.
example
integer
Optional
Minimum number of bedrooms.
10
integer
Optional
Maximum number of bedrooms.
10
integer
Optional
Minimum number of bathrooms.
10
integer
Optional
Maximum number of bathrooms.
10
integer
Optional
Minimum number of parking spaces.
10
integer
Optional
Maximum number of parking spaces.
10
integer
Optional
Minimum price in BRL. For rent this is the monthly rent.
10
integer
Optional
Maximum price in BRL.
10
integer
Optional
Minimum total area in square meters.
10
integer
Optional
Maximum total area in square meters.
10
integer
Optional
Minimum covered area in square meters.
10
integer
Optional
Maximum covered area in square meters.
10
string
Optional
owner for private sellers or company for agencies and developers.
example
string
Optional
Free text searched in the listing, 2 to 100 characters, without ; or :. Example: piscina.
running shoes
string
Optional
Comma separated amenities. A listing must have all of them. Example: piscina,churrasqueira,ar-condicionado.
example
string
Optional
under_construction, launching_soon, up_to_5_years, 5_to_10_years, 10_to_20_years, 20_to_50_years or over_50_years.
example
string
Optional
Same values as age_min. Must not come before age_min in that list.
example
string
Optional
today, since_yesterday, 7_days, 15_days, 30_days or 45_days.
example
boolean
Optional
true to list new developments only.
true
string
Optional
relevance (default), price_asc, price_desc, newest or price_drop.
relevance
integer
Optional
One-based page number, default 1. Results are reachable up to position 10,000.
1
integer
Optional
Results per page, 20 to 100, default 20.
10
Response Schema
Example response fields are illustrative; inspect the JSON before integrating.
Example response fields
Scan these fields before integrating.
data
meta
success
{
"data": {
"items": [
{
"id": "3040487028",
"geo": {
"latitude": -23.5476959,
"longitude": -46.6907959
},
"url": "https://www.imovelweb.com.br/propriedades/imoveis-no-sumarezinho-3040487028.html",
"tags": [],
"price": {
"amount": 12328,
"currency": "BRL",
"formatted": "R$ 12.328",
"starting_from": false
},
"title": "Imoveis - no Sumarezinho",
"prices": {
"sale": {
"amount": 12328,
"currency": "BRL",
"formatted": "R$ 12.328",
"starting_from": false
}
},
"address": {
"text": "R PAULIST\u00c2NIA, Sumarezinho, S\u00e3o Paulo, S\u00e3o Paulo",
"visibility": "EXACT",
"postal_code": "05440000"
},
"currency": "BRL",
"features": {
"suites": 1,
"garages": 1,
"bedrooms": 2,
"age_years": 1,
"bathrooms": 2,
"total_area": {
"unit": "m2",
"value": 500
},
"covered_area": {
"unit": "m2",
"value": 74
},
"condominium_fee": 1000
},
"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"
],
"amenities": [
{
"name": "Churrasqueira",
"category": "\u00c1reas Comuns"
},
{
"name": "Fitness/Sala de Gin\u00e1stica",
"category": "\u00c1reas Comuns"
},
{
"name": "Ar condicionado",
"category": "\u00c1reas Privativas"
}
],
"publisher": {
"id": "47852853",
"logo": "https://imgbr.imovelwebcdn.com/empresas/2/00/47/85/28/53/720x532/logo_pool-imoveis-guru_1769804567172.jpg",
"license": ".",
"is_premier": false
},
"description": "Apartamento \u00e0 venda na regi\u00e3o Sumarezinho - S\u00e3o Paulo - SP. 2 dormit\u00f3rios, 1 su\u00edtes, 1 vagas de garagem, \u00e1rea \u00fatil de 74 m\u00b2, \u00e1rea total de 500 m\u00b2. Car\u2026",
"unit_ranges": {
"units": null,
"garages": "1 vaga",
"bedrooms": "2 dorm.",
"bathrooms": "2 ban.",
"total_area": "500 m2"
},
"has_whatsapp": true,
"listing_type": "sale",
"posting_type": "property",
"published_at": "2026-08-21T03:58:42Z",
"internal_code": "809331",
"property_type": "Apartamento",
"first_online_at": "2026-07-17T04:00:00Z",
"property_subtype": "Padr\u00e3o"
},
{
"id": "3040487142",
"geo": {
"latitude": -23.5476959,
"longitude": -46.6907959
},
"url": "https://www.imovelweb.com.br/propriedades/imoveis-no-sumarezinho-3040487142.html",
"tags": [],
"price": {
"amount": 12328,
"currency": "BRL",
"formatted": "R$ 12.328",
"starting_from": false
},
"title": "Imoveis - no Sumarezinho",
"prices": {
"sale": {
"amount": 12328,
"currency": "BRL",
"formatted": "R$ 12.328",
"starting_from": false
}
},
"address": {
"text": "R PAULIST\u00c2NIA, Sumarezinho, S\u00e3o Paulo, S\u00e3o Paulo",
"visibility": "EXACT",
"postal_code": "05440000"
},
"currency": "BRL",
"features": {
"suites": 1,
"garages": 1,
"bedrooms": 2,
"age_years": 1,
"bathrooms": 2,
"total_area": {
"unit": "m2",
"value": 500
},
"covered_area": {
"unit": "m2",
"value": 74
},
"condominium_fee": 1000
},
"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"
],
"amenities": [
{
"name": "Churrasqueira",
"category": "\u00c1reas Comuns"
},
{
"name": "Fitness/Sala de Gin\u00e1stica",
"category": "\u00c1reas Comuns"
},
{
"name": "Ar condicionado",
"category": "\u00c1reas Privativas"
}
],
"publisher": {
"id": "47392357",
"logo": "https://imgbr.imovelwebcdn.com/empresas/2/00/47/39/23/57/720x532/logo_leardi-pompeia-268_1617801681630.jpg",
"license": "111",
"is_premier": false
},
"description": "Localizado no ponto mais alto da Vila Madalena, nas ruas mais charmosas e arborizadas da regi\u00e3o: Paulist\u00e2nia e Senador C\u00e9sar Lacerda Vergueiro. Um pro\u2026",
"unit_ranges": {
"units": null,
"garages": "1 vaga",
"bedrooms": "2 dorm.",
"bathrooms": "2 ban.",
"total_area": "500 m2"
},
"has_whatsapp": false,
"listing_type": "sale",
"posting_type": "property",
"published_at": "2026-08-21T03:59:14Z",
"internal_code": "809331",
"property_type": "Apartamento",
"first_online_at": "2026-07-17T04:00:00Z",
"property_subtype": "Padr\u00e3o"
}
],
"pagination": {
"page": 1,
"offset": 0,
"per_page": 20,
"returned": 20,
"max_offset": 10000,
"has_next_page": true,
"total_reported": 32221,
"duplicates_removed": 0
},
"applied_filters": {
"sort": "relevance",
"location": "V1-Z-52",
"bedrooms_min": 2,
"listing_type": "sale"
}
},
"meta": {
"billable": true,
"endpoint_family": "search"
},
"success": true
}Errors
Handle these documented responses before retrying or showing customer-facing failures.
Validation Error
A value is outside its allowed list, a range is reversed, or the page is beyond result 10,000 (narrow your filters). This response is not billable.
{
"errors": {
"query": [
"The query field is required."
]
},
"message": "The request validation failed"
}Upstream Unavailable
Imovelweb could not be reached, or returned data that does not match the expected shape. Retry shortly. This response is not billable.
{
"meta": {
"billable": false,
"retryable": true,
"endpoint_family": "search"
},
"error": {
"code": "UPSTREAM_UNAVAILABLE",
"message": "Imovelweb could not be reached. Please retry shortly."
},
"success": false
}Generate Code with AI
Copy a ready-made prompt with all the endpoint details, parameters, and example responses. Paste it into ChatGPT, Claude, or any AI assistant to instantly generate working code.
Try It Live
Test this endpoint in our interactive playground with real data.