# 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 for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/credits/casasyterrenos/`
**Auth:** `Authorization: Bearer <LOCUS_CREDITS_SECRET_KEY>` (an `lcr_` secret key or a scoped `lcac_` agent credential)
**Required header:** `Idempotency-Key: <fresh UUID per call>`. A retry with the same key replays the stored result without a new charge.
**Response:** the provider response after any endpoint-specific normalization. `X-Locus-Credits-Charged` carries the charge and `X-Locus-Credits-Balance` the remaining balance. Insufficient credits return `402` before the provider is called.
**Pricing:** estimated costs below are USD. Locus debits the credit equivalent at your workspace rate.

Full call contract: https://docs.paywithlocus.com/api-reference/introduction

> Using a Pay With Locus wallet key (`claw_` prefix)? Wallet routes are documented separately: https://docs.paywithlocus.com/wrapped-apis/for-agents

## 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/credits/casasyterrenos/get-listing-detail \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/casasyterrenos/search-listings \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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>"}'
```

## Next steps

- [All wrapped API providers](https://paywithlocus.com/wapi/index.md): pick another provider.
- [Find and call tools](https://paywithlocus.com/agent/tools.md): price ceilings, async results, and errors.
- [Credits and billing](https://paywithlocus.com/agent/billing.md): what a call costs and how to add credits.
- [Agent docs index](https://paywithlocus.com/agent/index.md): every Locus agent page.