remax.pt APIremax.pt ↗
Search and retrieve real estate development listings from RE/MAX Portugal. Filter by county, price, bedrooms, and area. Access units, floor plans, and agent data.
curl -X POST 'https://api.parse.bot/scraper/4712a94d-de4e-4a83-bacd-a5a1dbcb4f5a/search_developments' \
-H 'X-API-Key: $PARSE_API_KEY' \
-H 'Content-Type: application/json' \
-d '{}'Search developments (empreendimentos) on RE/MAX Portugal with optional filters for county, price range, bedrooms, and area. Returns paginated results with development details and their associated units (listings).
| Param | Type | Description |
|---|---|---|
| page | integer | Zero-based page number for pagination. |
| sort | string | Sort field with optional - prefix for descending. Accepts: -PublishDate, PublishDate, -minimumPrice, minimumPrice, name, -name. |
| county | string | County (concelho) slug to filter by, lowercase with hyphens (e.g. 'lisboa', 'cascais', 'porto'). Use list_regions endpoint to get valid values from the region_search field. |
| bedrooms | string | Filter by number of bedrooms in units (e.g. '2'). |
| max_area | string | Maximum total area filter in m² (e.g. '200'). |
| min_area | string | Minimum total area filter in m² (e.g. '50'). |
| max_price | string | Maximum price filter in euros (e.g. '500000'). |
| min_price | string | Minimum price filter in euros (e.g. '100000'). |
| page_size | integer | Number of results per page (1-100). |
| search_value | string | Free-text search query to filter developments by name. |
{
"type": "object",
"fields": {
"page": "integer",
"total": "integer",
"results": "array of development objects with nested units",
"page_size": "integer",
"total_pages": "integer",
"has_next_page": "boolean",
"has_previous_page": "boolean"
},
"sample": {
"page": 0,
"total": 644,
"results": [
{
"id": 8882,
"name": "Palm Luxury Living",
"units": [
{
"id": 7153157,
"floor": null,
"price": 1790000,
"garage": true,
"is_sold": false,
"parking": false,
"bedrooms": 4,
"lot_size": null,
"bathrooms": 5,
"is_active": true,
"total_area": 216,
"living_area": 216,
"garage_spots": 3,
"listing_type": "Moradia",
"publish_date": "2026-05-15T15:09:11.23",
"region_name2": "Cascais",
"region_name3": "Carcavelos e Parede",
"business_type": "Venda",
"listing_title": "124031323-23",
"energy_efficiency": 8
}
],
"active": true,
"agent_id": "124031323",
"latitude": 38.687874240609396,
"pictures": [
"developments/8882/89951565-a40f-4141-a93a-35f7308b4079.jpg"
],
"zip_code": "2775-685",
"is_online": true,
"longitude": -9.3288962149551,
"office_id": 340,
"agent_name": "Ana Chitas",
"is_special": true,
"local_zone": "Carcavelos",
"office_name": "RE/MAX ConviCtus Baía",
"publish_date": "2026-06-03T14:03:24.71",
"region_name1": "Lisboa",
"region_name2": "Cascais",
"region_name3": "Carcavelos e Parede",
"minimum_price": 1790000,
"listings_count": 4,
"has_active_listings": true
}
],
"page_size": 2,
"total_pages": 322,
"has_next_page": true,
"has_previous_page": false
}
}About the remax.pt API
The RE/MAX Portugal API gives developers structured access to residential development listings across Portugal through 3 endpoints. Use search_developments to query the full catalog with filters for county, price range, bedrooms, and area, then drill into any result with get_development to retrieve individual unit details, floor plans, video paths, GPS coordinates, and virtual tour availability.
What the API Covers
The API surfaces RE/MAX Portugal's empreendimentos (developments) catalog — multi-unit residential projects listed by RE/MAX agents across Portugal. Each development groups one or more individual units (apartments, townhouses, etc.) under a single project listing. The three endpoints cover catalog search, single-development detail, and region enumeration.
Searching and Filtering Developments
The search_developments endpoint accepts POST requests with optional filters: county (a slug like 'lisboa' or 'cascais'), min_price/max_price in euros, min_area/max_area in m², and bedrooms. Results are paginated; the response includes total, total_pages, has_next_page, and has_previous_page alongside an array of development objects that each embed nested unit listings. Sorting is controlled via the sort parameter using values like -PublishDate (newest first) or -minimumPrice.
Development Detail and Region Lookup
get_development accepts a numeric development_id (obtained from results[*].id in the search response) and returns the full development record: name, latitude, zip_code, agent_id, pictures (array of image paths), videos, is_online status, and a detailed units array that adds original price, floor plan references, and virtual tour availability not present in search results. The list_regions endpoint takes no parameters and returns the complete set of county slugs valid for the county filter in search_developments.
- Build a Portugal property search portal filtered by county, price band, and bedroom count
- Aggregate development inventory across RE/MAX Portugal listings for market analysis
- Monitor new developments using the
-PublishDatesort andpublish_datefield - Display development location pins on a map using the
latitudefield fromget_development - Compile floor plan and virtual tour availability across listings for a buyer comparison tool
- Populate a CRM with RE/MAX Portugal agent IDs and their associated development listings
- Generate price-per-m² statistics using
min_area,max_area, and price range filter combinations
| 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 RE/MAX Portugal offer an official developer API?+
What additional fields does `get_development` return compared to `search_developments`?+
get_development adds fields not present in search results: videos (array of video path strings), pictures (array of image paths), latitude, zip_code, agent_id, is_online, and per-unit fields including original price, floor plan references, and virtual tour availability.How do I know which county slugs are valid for the `county` filter?+
list_regions first — it returns a regions array containing all valid county slugs (e.g. 'lisboa', 'cascais', 'porto'). Pass any of those values as the county parameter in search_developments.Does the API cover RE/MAX Portugal resale (used) property listings, not just new developments?+
empreendimentos) catalog only — multi-unit new-build projects. Individual resale listings from remax.pt are not included. You can fork this API on Parse and revise it to add an endpoint targeting the resale listings section.