# Remax — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Search and browse real estate developments and units across Portugal through RE/MAX's platform, filtering by your preferences to find properties that match your needs. Access detailed information about specific developments, individual units, and explore listings organized by region.

**Category:** Real Estate | **Website:** [remax.pt/en/comprar-empreendimentos](https://remax.pt/en/comprar-empreendimentos) | **Docs:** [parse.bot/marketplace/9e981eb1-62ac-4153-9b13-79e02b8455e1/remax-pt-api](https://parse.bot/marketplace/9e981eb1-62ac-4153-9b13-79e02b8455e1/remax-pt-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-remax-pt-api-9e981eb1/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_development

Get detailed information about a specific development by its ID, including full unit listings with additional fields like original price, floor plans, and virtual tour availability. Returns a single development object with all units and metadata. Descriptions are returned as arrays of language-variant objects.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `development_id` | string | Yes | Numeric development ID (e.g. '8882'). Obtainable from the search_developments endpoint results[*].id field. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-remax-pt-api-9e981eb1/get_development \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"development_id":"<string>"}'
```

### list_regions

List all available Portuguese regions (counties/concelhos) that can be used to filter developments in the search_developments endpoint. Returns a complete list of regions with their search slugs, district information, and coordinates.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-remax-pt-api-9e981eb1/list_regions \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### search_developments

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. Paginates via zero-based page number. Each development contains nested unit listings with pricing, area, and status information.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `bedrooms` | string | No | Filter by number of bedrooms in units (e.g. '2'). |
| `county` | string | No | 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. |
| `max_area` | string | No | Maximum total area filter in square meters (e.g. '200'). |
| `max_price` | string | No | Maximum price filter in euros (e.g. '500000'). |
| `min_area` | string | No | Minimum total area filter in square meters (e.g. '50'). |
| `min_price` | string | No | Minimum price filter in euros (e.g. '100000'). |
| `page` | integer | No | Zero-based page number for pagination. |
| `page_size` | integer | No | Number of results per page (1-100). |
| `search_value` | string | No | Free-text search query to filter developments by name. |
| `sort` | string | No | Sort field with optional - prefix for descending. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-remax-pt-api-9e981eb1/search_developments \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"bedrooms":"<string>","county":"<string>","max_area":"<string>","max_price":"<string>","min_area":"<string>","min_price":"<string>","page":"<integer>","page_size":"<integer>","search_value":"<string>","sort":"<string>"}'
```