# Encuentra24 — 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.

> Browse Encuentra24 real estate listings by region and property category, and retrieve full details for individual listings including price, attributes, description, photos, and seller contact info.

**Category:** Real Estate | **Website:** [encuentra24.com/](https://encuentra24.com/) | **Docs:** [parse.bot/marketplace/ef096305-97b8-4e3e-8030-e49a80238f30/encuentra24-com-api](https://parse.bot/marketplace/ef096305-97b8-4e3e-8030-e49a80238f30/encuentra24-com-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-encuentra24-com-api-ef096305/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_listing_details

Fetch comprehensive details for a single listing by its full URL. Returns core attributes (size, bedrooms, bathrooms), full description, price breakdown, seller contact info, additional property details, photo/media URLs, and coordinates when available. The listing_url is typically obtained from search_listings results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `listing_url` | string | Yes | Full listing URL from Encuentra24 (e.g. from search_listings results[].url). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-encuentra24-com-api-ef096305/get_listing_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"listing_url":"<string>"}'
```

### get_regions

Retrieve region slugs from the Encuentra24 AJAX endpoint. Returns all regions at a given hierarchy level (2=provinces, 3=cities/districts, 4=neighborhoods, 5=sub-neighborhoods). Use the returned slug values as the region_slug parameter in search_listings.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `country_lang` | string | No | Country/language prefix in URL. |
| `level` | integer | No | Region hierarchy level (2=provinces, 3=cities/districts, 4=neighborhoods, 5=sub-neighborhoods). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-encuentra24-com-api-ef096305/get_regions \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"country_lang":"<string>","level":"<integer>"}'
```

### search_listings

Search real estate listings by category (property type) and region. Returns paginated results (20 per page from the site). Use get_regions to discover valid region_slug values. Each listing summary includes ad_id, title, price, location, and basic specs (bedrooms/bathrooms/area). Paginate via the page parameter; total_results and pagination metadata indicate how many pages are available.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category_slug` | string | No | Search category slug (property type). Common values: bienes-raices-venta-de-propiedades-apartamentos (apartments for sale), bienes-raices-venta-de-propiedades-casas (houses for sale), bienes-raices-alquiler-apartamentos (apartments for rent). |
| `country_lang` | string | No | Country/language prefix in URL. |
| `limit` | integer | No | Max listings to return from the page. |
| `page` | integer | No | Results page number (1-based). |
| `region_slug` | string | Yes | Region slug to filter by location. Obtain valid slugs from get_regions endpoint. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-encuentra24-com-api-ef096305/search_listings \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"category_slug":"<string>","country_lang":"<string>","limit":"<integer>","page":"<integer>","region_slug":"<string>"}'
```