# Inmuebles24 — 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 from inmuebles24.com, Mexico's leading property portal. Filter by property type, operation type, and location, with pagination support to explore available rentals and sales across regions and property categories.

**Category:** Real Estate | **Website:** [www.inmuebles24.com/](https://www.inmuebles24.com/) | **Docs:** [parse.bot/marketplace/f22d83d2-218d-481c-ad18-82aed77f9f7c/inmuebles24-com-api](https://parse.bot/marketplace/f22d83d2-218d-481c-ad18-82aed77f9f7c/inmuebles24-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/inmuebles24/`
**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

### Search listings

Search for real estate listings by location, property type, and operation type. Returns structured listing data including price, features, structured location with coordinates, images, agency info, and URLs. Each page contains 30 listings (fixed by the site). Paginates by page number; use max_pages to control how many pages to fetch, or all_pages=true to auto-paginate through all results. When all_pages is true, pagination stops when a page returns fewer than 30 results or after 100 pages.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `all_pages` | boolean | No | When true, automatically paginates through all available result pages until results are exhausted (fewer than 30 results on a page or 100 pages max). When false, page and max_pages control pagination. |
| `max_pages` | integer | No | Maximum number of pages to fetch (ignored when all_pages is true) |
| `operation` | string | No | Operation type for the listing search |
| `page` | integer | No | Starting page number (1-based) |
| `property_type` | string | No | Property type slug |
| `query` | string | No | Location slug for search (e.g., 'ciudad-de-mexico', 'guadalajara', 'monterrey', 'puebla') |
| `sort` | string | No | Sort order for results |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/inmuebles24/search-listings \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"all_pages":"<boolean>","max_pages":"<integer>","operation":"<string>","page":"<integer>","property_type":"<string>","query":"<string>","sort":"<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.