imovelweb.com.br APIimovelweb.com.br ↗
Search and retrieve Brazilian apartment listings from imovelweb.com.br. Get prices, room counts, features, and full descriptions via 2 structured endpoints.
curl -X GET 'https://api.parse.bot/scraper/2ade82c9-9917-40f4-93e5-34773a7c4950/search_apartments?city=sao-paulo&page=1&state=sao-paulo' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for apartments for sale on Imovelweb based on location (neighborhood, city, state). Returns paginated results with listing summaries including price, location, features, and links to detail pages.
| Param | Type | Description |
|---|---|---|
| city | string | City name. |
| page | integer | Page number for pagination. |
| state | string | State name. |
| neighborhood | string | Neighborhood name. Accents are normalized automatically (e.g. 'juveve' for Juvevê). |
{
"type": "object",
"fields": {
"city": "string city searched",
"page": "integer current page number",
"count": "integer total number of listings on this page",
"listings": "array of listing objects with id, price, location, description, features_summary, url, and optional size_m2, rooms, bathrooms, parking_spaces",
"neighborhood": "string neighborhood searched"
},
"sample": {
"data": {
"city": "curitiba",
"page": 1,
"count": 30,
"listings": [
{
"id": "3012010762",
"url": "https://www.imovelweb.com.br/propriedades/cobertura-nova-e-bem-iluminada-no-juveve-3012010762.html",
"price": "R$ 2.200.000",
"rooms": 3,
"size_m2": 185,
"location": "Juvevê, Curitiba",
"bathrooms": 3,
"description": "Moderno e conectado à natureza...",
"features_summary": "185 m² tot. 3 quartos 3 ban."
}
],
"neighborhood": "juveve"
},
"status": "success"
}
}About the imovelweb.com.br API
The Imovelweb API provides access to apartment listings on imovelweb.com.br through 2 endpoints. Use search_apartments to query listings by city, state, or neighborhood and get back paginated summaries — including price, location, size, and rooms — then call get_listing_details with any returned URL to retrieve the full property description and complete feature list.
What the API Covers
The API covers apartment-for-sale listings on imovelweb.com.br, one of Brazil's major real estate portals. Both endpoints return structured data in English-friendly field names, handling Portuguese accent normalization automatically — for example, passing juveve resolves listings in Juvevê.
search_apartments
Accepts optional city, state, neighborhood, and page parameters. The response includes a listings array where each object carries: id, price, location, description, features_summary, url, and optional fields size_m2, rooms, bathrooms, and par. The count field tells you how many listings are on the current page, and page confirms which page was returned. Pagination is controlled by incrementing the page parameter.
get_listing_details
Accepts a single required url parameter — the full imovelweb.com.br listing URL, typically taken from a search_apartments result's url field. The response returns all_features as an array of strings (covering area, rooms, bathrooms, and other property attributes) and full_description as a free-text string, or null when the listing has no description text. This is the right endpoint for building a detailed property record or populating a comparison view.
Scope and Limitations
The current endpoints cover apartment listings only. Rental listings, houses, commercial properties, and land parcels are outside the current scope. Neighborhood names with accents can be passed without diacritics. Listing freshness reflects what is currently published on the site at query time.
- Aggregate apartment prices by neighborhood to build a Brazilian real estate price index
- Track listing counts per city and page to estimate market inventory over time
- Pull
size_m2,rooms, andpricefrom search results to calculate price-per-square-meter comparisons - Feed
full_descriptionandall_featuresinto an LLM to auto-tag property amenities - Monitor a specific Imovelweb listing URL for changes in price or description
- Build a filtered apartment search tool for specific Brazilian cities or neighborhoods
- Populate a property portfolio tracker with structured listing data from São Paulo or Curitiba neighborhoods
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does imovelweb.com.br have an official public developer API?+
What does search_apartments return for each listing in the results array?+
id, price, location, description, features_summary, and url. Where the source data is present, size_m2, rooms, bathrooms, and par are also included. Fields like size_m2 or rooms may be absent if the listing does not publish that data.Does the API cover rental listings, houses, or commercial properties?+
How does pagination work in search_apartments?+
page parameter to advance through result pages. The response returns the current page number and a count of listings on that page. There is no total-page-count field in the response, so you continue paginating until count drops to zero or a page returns no listings.Can I retrieve images or contact details from a listing?+
get_listing_details returns all_features and full_description only. Listing photos, agent contact details, and map coordinates are not exposed. You can fork the API on Parse and revise it to add those fields.