# Casasyterrenos — 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 across Mexico with detailed property information, pricing, and seller contacts from Casas y Terrenos. Find your perfect home or land by accessing comprehensive property details and comparing available options in one place.

**Category:** Real Estate | **Website:** [casasyterrenos.com/](https://casasyterrenos.com/) | **Docs:** [parse.bot/marketplace/552596f6-e8f4-440b-ab5c-5ff68e8cc5ce/casasyterrenos-com-api](https://parse.bot/marketplace/552596f6-e8f4-440b-ab5c-5ff68e8cc5ce/casasyterrenos-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-casasyterrenos-com-api-552596f6/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_listing_detail

Get full details for a specific property listing by its slug or URL path. Returns comprehensive property information including features, images, seller contact, coordinates, pricing, and amenities. The slug is obtained from search_listings results via the 'canonical' field. A single round-trip to the site's data layer.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug_or_url` | string | Yes | Property slug or path. Can be a full path like '/propiedad/<property-slug>' or just the slug portion. Obtain from search_listings results via the 'canonical' or 'slugs' fields. |

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

### search_listings

Search for real estate listings (houses, apartments, land, etc.) by state, municipality, property type, and operation. Returns paginated results with up to 40 listings per page. Listings include summary info: price, size, rooms, broker contact, and a canonical slug for drill-down via get_listing_detail. Pagination is zero-based; sort defaults to featured listings first.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `bathrooms` | integer | No | Minimum number of bathrooms. |
| `bedrooms` | integer | No | Minimum number of bedrooms. |
| `city` | string | No | Municipality/city name slug to filter within the state (e.g., 'monterrey', 'guadalajara', 'zapopan'). Hyphens are replaced with spaces and title-cased for matching. |
| `max_price` | integer | No | Maximum price in MXN. Filters on priceSale for venta, priceRent for renta. |
| `min_price` | integer | No | Minimum price in MXN. Filters on priceSale for venta, priceRent for renta. |
| `operation` | string | No | Operation type. |
| `page` | integer | No | Page number (0-indexed). Each page returns up to 40 results. |
| `parking` | integer | No | Minimum number of parking spaces. |
| `property_type` | string | No | Property type slug. |
| `sort` | string | No | Sort order. Omitting sorts by featured listings first. |
| `state` | string | Yes | Mexican state name slug in lowercase hyphenated form (e.g., 'jalisco', 'nuevo-leon', 'ciudad-de-mexico', 'quintana-roo'). Corresponds to all 32 Mexican states. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-casasyterrenos-com-api-552596f6/search_listings \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"bathrooms":"<integer>","bedrooms":"<integer>","city":"<string>","max_price":"<integer>","min_price":"<integer>","operation":"<string>","page":"<integer>","parking":"<integer>","property_type":"<string>","sort":"<string>","state":"<string>"}'
```