# Fincaraiz — 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 listings, projects, and agencies from Colombia's leading property platform, plus stay updated with the latest real estate news and market insights. Filter properties by type, view detailed listing information, and discover available inmobiliarias all in one place.

**Category:** Real Estate | **Website:** [fincaraiz.com.co/](https://fincaraiz.com.co/) | **Docs:** [parse.bot/marketplace/c7c7457a-adf0-4b5a-81b0-4255f24b8b39/fincaraiz-com-co-api](https://parse.bot/marketplace/c7c7457a-adf0-4b5a-81b0-4255f24b8b39/fincaraiz-com-co-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-fincaraiz-com-co-api-c7c7457a/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_listing_detail

Retrieve full details for a single property listing including technical sheet, images, owner info, location data, and facilities. Both slug_or_url and property_id are required. The slug and ID are available from search_listings results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `property_id` | string | Yes | Listing ID (e.g., '193577571'). Available from search_listings results[*].id. |
| `slug_or_url` | string | Yes | Listing slug (e.g., 'apartamento-en-venta-en-santa-barbara-bogota') or full URL. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-fincaraiz-com-co-api-c7c7457a/get_listing_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"property_id":"<string>","slug_or_url":"<string>"}'
```

### get_news_articles

Retrieve real estate news articles from the Fincaraiz blog (WordPress). Returns paginated posts with full HTML content, author info, and category data. 10 articles per page.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number for pagination. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-fincaraiz-com-co-api-c7c7457a/get_news_articles \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>"}'
```

### list_inmobiliarias

List real estate agencies (inmobiliarias) featured on the platform. Returns agencies with their profile details including name, type, logo, description, and contact info.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-fincaraiz-com-co-api-c7c7457a/list_inmobiliarias \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### list_property_types

List all available property types for filtering search results. Returns property type slugs and display names used in the property_type parameter of search_listings.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-fincaraiz-com-co-api-c7c7457a/list_property_types \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### search_by_code

Search for a property listing by its Fincaraiz listing code or numeric ID. Returns the first matching listing's full data object.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `code` | string | Yes | Property code or numeric ID (e.g., '193577571'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-fincaraiz-com-co-api-c7c7457a/search_by_code \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"code":"<string>"}'
```

### search_listings

Search for property listings on fincaraiz.com.co with filters for location, operation type, property type, price range, area, estrato, and bedrooms. Returns paginated results ordered by relevance. Each listing includes full details: price, location, owner, images, facilities, and technical specs.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `bedrooms` | integer | No | Number of bedrooms to filter by (e.g., 1, 2, 3, 4). Passed as the habitaciones URL parameter. |
| `estrato` | integer | No | Estrato level (1-6). |
| `location` | string | No | Location slug (e.g., 'bogota-dc', 'medellin', 'colombia'). |
| `max_area` | integer | No | Maximum area in m². |
| `max_price` | integer | No | Maximum price in COP. |
| `min_area` | integer | No | Minimum area in m². |
| `min_price` | integer | No | Minimum price in COP. |
| `operation` | string | No | Operation type. |
| `page` | integer | No | Page number for pagination. |
| `property_type` | string | No | Property type slug (e.g., 'apartamentos', 'casas', 'finca-raiz'). Use list_property_types endpoint to get available slugs. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-fincaraiz-com-co-api-c7c7457a/search_listings \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"bedrooms":"<integer>","estrato":"<integer>","location":"<string>","max_area":"<integer>","max_price":"<integer>","min_area":"<integer>","min_price":"<integer>","operation":"<string>","page":"<integer>","property_type":"<string>"}'
```