# Propiedades.com Search API Documentation

<p><strong>Propiedades.com Search API</strong> returns up to 47 listings per page for sale or rent in one or more locations. Filter by type, subtype, price, built area, exact bedrooms and bathrooms, amenities and auctions, and sort by price or bedrooms. Every item satisfies the filters you sent; items that break a filter are never returned and are counted in <code>excluded_by_filters</code>. <code>pagination.total_items</code> is the total the site reports for the same filters, before the exact bedroom and bathroom rule. A page past the last returns an empty list. Failed requests are not billed.</p>

- **Documentation:** [https://scrappa.co/docs/propiedades-com-api/propiedades_com_search](https://scrappa.co/docs/propiedades-com-api/propiedades_com_search)
- **API group:** Propiedades.com API
- **Endpoint:** `GET https://scrappa.co/api/propiedades-com/search`

## Authentication

Send your Scrappa API key in the `X-API-KEY` request header. Paid endpoints also support accountless x402 payments when called without an API key.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `location_id` | string | Yes | Required. Location id from the autocomplete route. Send a comma list of up to 10 ids to search several areas. Example: 150028. |
| `purpose` | string | No | sale (default), rent or both. |
| `type` | string | No | residential (default), commercial or industrial. |
| `subtype` | string | No | A subtype of the type. residential: apartments, houses, residential-land, condominium-houses. commercial: offices, commercial-land, buildings, retail-spaces. industrial: industrial-warehouses. Omit for all. A subtype from another type returns 422. |
| `price_min` | number | No | Minimum price in MXN. Listings priced in another currency are left out when a price filter is set. |
| `price_max` | number | No | Maximum price in MXN. Listings priced in another currency are left out when a price filter is set. |
| `size_min` | number | No | Minimum built area in square metres. |
| `size_max` | number | No | Maximum built area in square metres. |
| `bedrooms` | integer | No | Exact bedroom count. Rows with a different count are removed, so a page can hold fewer than 47 items. |
| `bathrooms` | integer | No | Exact bathroom count. Rows with a different count are removed, so a page can hold fewer than 47 items. |
| `auctions` | boolean | No | true to return foreclosure auction listings (remates) only. |
| `amenities` | array | No | Comma list or repeated parameter of: nuevo, usado, alberca, jardin, mascotas, amueblado, estacionamientos. |
| `sort` | string | No | price_asc, price_desc, bedrooms_asc or bedrooms_desc. Default is the site relevance order. price_desc is not strictly sorted because promoted listings come first. There is no date sort. |
| `page` | integer | No | 1-based page number, 1 to 500. 47 listings per page. A page past the last one returns an empty list. |

## Example response

```json
{
    "data": {
        "items": [
            {
                "id": 31599911,
                "url": "https://propiedades.com/inmuebles/departamento-en-renta-andres-bello-polanco-iv-seccion-df-31599911",
                "type": "Residencial",
                "flags": {
                    "new": false,
                    "auction": false,
                    "showroom": false,
                    "exclusive": false,
                    "off_market": false,
                    "highlighted": true,
                    "whatsapp_verified": true
                },
                "price": 110000,
                "title": "Departamento en renta Andr\u00e9s Bello, Col. Polanco IV Secci\u00f3n",
                "address": {
                    "city": "Miguel Hidalgo",
                    "state": "DF / CDMX",
                    "colony": "Polanco IV Secci\u00f3n",
                    "street": "Andr\u00e9s Bello",
                    "zipcode": "11550",
                    "full_address": "Andr\u00e9s Bello, Col. Polanco IV Secci\u00f3n C.P. 11550, Miguel Hidalgo",
                    "municipality": "Miguel Hidalgo"
                },
                "purpose": "Renta",
                "subtype": "Departamento",
                "type_id": 1,
                "bedrooms": 3,
                "currency": "MXN",
                "latitude": 19.4303847,
                "amenities": {
                    "pool": false,
                    "terrace": true,
                    "elevator": true,
                    "furnished": false,
                    "pets_allowed": true,
                    "private_security": true
                },
                "bathrooms": 3,
                "longitude": -99.1868662,
                "thumbnail": "https://propiedadescom.s3.amazonaws.com/files/292x200/DF-CDMX-Polanco-IV-Seccion-Andres-Bello-Miguel-Hidalgo-0-31599911.png",
                "purpose_id": 2,
                "subtype_id": 1,
                "modified_at": "14/10/2026",
                "photo_count": 25,
                "published_at": "2026-07-23 01:19:20",
                "built_area_m2": 317,
                "parking_spaces": 2,
                "days_listed_label": "3 meses en Propiedades.com"
            }
        ],
        "location": {
            "id": "150028",
            "city": "Zona Polanco",
            "label": "Zona Polanco, Ciudad de M\u00e9xico / CDMX",
            "state": "Ciudad de M\u00e9xico / CDMX",
            "colony": null
        },
        "pagination": {
            "page": 1,
            "per_page": 47,
            "next_page": 2,
            "total_items": 1185,
            "total_pages": 26
        },
        "excluded_by_filters": 0
    },
    "meta": {
        "billable": true,
        "endpoint_family": "search"
    },
    "success": true
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | A parameter is missing or invalid. This response is not billable. |
| 503 | Upstream Unavailable | Propiedades.com could not be reached, or returned data that does not match the request. This response is not billable and is retryable. |

## More Scrappa resources

- [API documentation](https://scrappa.co/docs)
- [Full LLM-readable API reference](https://scrappa.co/llms-full.txt)
- [OpenAPI specification](https://scrappa.co/docs/api.json)
- [Pricing](https://scrappa.co/pricing)