---
title: "Propiedades.com API: Search | Perceptlayer"
description: "Search from Propiedades.com as JSON. 1 credit per successful call."
url: https://perceptlayer.com/apis/propiedades-com/search
---

[APIs](https://perceptlayer.com/apis) / [Propiedades.com](https://perceptlayer.com/apis/propiedades-com) / Search

# Propiedades.com: Search

Search from Propiedades.com as JSON. 1 credit per successful call.

GET `/v1/propiedades-com/search`

## Parameters

Send parameters in the query string.

| Parameter | Type | Required | Allowed values |
| --- | --- | --- | --- |
| `purpose` | string | Optional | sale, rent, both |
| `type` | string | Optional | residential, commercial, industrial |
| `subtype` | string | Optional | Up to 40 characters |
| `location_id` | string | Required | Up to 200 characters |
| `price_min` | number | Optional | Any |
| `price_max` | number | Optional | Any |
| `size_min` | number | Optional | Any |
| `size_max` | number | Optional | Any |
| `bedrooms` | integer | Optional | Any |
| `bathrooms` | integer | Optional | Any |
| `auctions` | boolean | Optional | Any |
| `amenities[]` | list of string | Optional | nuevo, alberca, jardin, mascotas, usado, amueblado, estacionamientos |
| `sort` | string | Optional | price\_asc, price\_desc, bedrooms\_asc, bedrooms\_desc |
| `page` | integer | Optional | Any |

## Example request

Propiedades.com

GET /v1/propiedades-com/search?purpose=rent&subtype=apartments&location\_id=150028&bedrooms=3 

```
{
  "success": true,
  "data": {
    "items": [
      {
        "id": 31727116,
        "url": "https://propiedades.com/inmuebles/departamento-en-renta-galileo-polanco-iv-seccion-df-31727116",
        "title": "Departamento en renta Galileo, Col. Polanco IV Sección",
        "purpose": "Renta",
        "purpose_id": 2,
        "type": "Residencial",
        "type_id": 1,
        "subtype": "Departamento",
        "subtype_id": 1,
        "price": 58500,
        "currency": "MXN",
        "bedrooms": 3,
        "bathrooms": 4,
        "built_area_m2": 155,
        "parking_spaces": 2,
        "latitude": 19.4303847,
        "longitude": -99.1868662,
        "address": {
          "state": "DF / CDMX",
          "city": "Miguel Hidalgo",
          "municipality": "Miguel Hidalgo",
          "colony": "Polanco IV Sección",
          "zipcode": "11550",
          "street": "Galileo",
          "full_address": "Galileo, Col. Polanco IV Sección C.P. 11550, Miguel Hidalgo"
        },
        "thumbnail": "https://propiedadescom.s3.amazonaws.com/files/292x200/DF-CDMX-Polanco-IV-Seccion-Galileo-Miguel-Hidalgo-0-31727116.jpeg",
        "photo_count": 19,
        "published_at": "2026-09-01 02:16:24",
        "modified_at": "21/10/2026",
        "days_listed_label": "2 meses en Propiedades.com",
        "flags": {
          "new": false,
          "exclusive": false,
          "auction": false,
          "highlighted": true,
          "off_market": false,
          "showroom": false,
          "whatsapp_verified": true
        },
        "amenities": {
          "basement": false,
          "fireplace": false,
          "cistern": false,
          "furnished": false,
          "gym": false,
          "heating": false,
          "laundry_area": false,
          "natural_gas": false,
          "pets_allowed": false,
          "pool": false,
          "private_security": true,
          "service_room": true,
          "terrace": true,
          "elevator": true,
          "loading_docks": false,
          "air_conditioning": false,
          "cctv": false,
          "emergency_plan": false,
          "optical_fiber": false,
          "telephony": false,
          "surveillance": false,
          "electricity": false,
          "fire_system": false,
          "truck_scale": false,
          "ventilation": false,
          "lighting": false
        }
      },
      {
        "id": 31422621,
        "url": "https://propiedades.com/inmuebles/departamento-en-renta-c-monte-elbruz-148-polanco-lomas-de-chapultepec-iii-secc-miguel-hidalgo-11560-ciudad-de-mexico-148-polanco-v-seccion-df-31422621",
        "title": "Departamento en renta C. Monte Elbruz 148, Polanco, Lomas de Chapultepec III Secc, Miguel Hidalgo, 11560 Ciudad de México, #148Int. 901, Col. Polanco V Sección",
        "purpose": "Renta",
        "purpose_id": 2,
        "type": "Residencial",
        "type_id": 1,
        "subtype": "Departamento",
        "subtype_id": 1,
        "price": 75000,
        "currency": "MXN",
        "bedrooms": 3,
        "bathrooms": 4,
        "built_area_m2": 297,
        "latitude": 19.4297602,
        "longitude": -99.203929,
        "address": {
          "state": "DF / CDMX",
          "city": "Miguel Hidalgo",
          "municipality": "Miguel Hidalgo",
          "colony": "Polanco V Sección",
          "zipcode": "11560",
          "street": "C. Monte Elbruz 148, Polanco, Lomas de Chapultepec III Secc, Miguel Hidalgo, 11560 Ciudad de México, #148Int. 901",
          "full_address": "C. Monte Elbruz 148, Polanco, Lomas de Chapultepec III Secc, Miguel Hidalgo, 11560 Ciudad de México, #148Int. 901, Col. Polanco V Sección C.P. 11560, Miguel Hidalgo"
        },
        "thumbnail": "https://propiedadescom.s3.amazonaws.com/files/292x200/4a688859-5f68-11f1-8317-bd14b34a4ab1.jpeg",
        "photo_count": 17,
        "published_at": "2026-06-03 16:19:06",
        "modified_at": "11/11/2026",
        "days_listed_label": "5 meses en Propiedades.com",
        "flags": {
          "new": false,
          "exclusive": false,
          "auction": false,
          "highlighted": true,
          "off_market": false,
          "showroom": false,
          "whatsapp_verified": true
        },
        "amenities": {
          "basement": false,
          "fireplace": false,
          "cistern": false,
          "furnished": false,
          "gym": false,
          "heating": false,
          "laundry_area": false,
          "natural_gas": false,
          "pets_allowed": false,
          "pool": false,
          "private_security": true,
          "service_room": true,
          "terrace": true,
          "elevator": true,
          "loading_docks": false,
          "air_conditioning": false,
          "cctv": false,
          "emergency_plan": false,
          "optical_fiber": false,
          "telephony": false,
          "surveillance": false,
          "electricity": false,
          "fire_system": false,
          "truck_scale": false,
          "ventilation": false,
          "lighting": false
        }
      },
      {
        "id": 31841566,
        "url": "https://propiedades.com/inmuebles/departamento-en-renta-andres-bello-polanco-iv-seccion-df-31841566",
        "title": "Departamento en renta ANDRES BELLO, Col. Polanco IV Sección",
        "purpose": "Renta",
        "purpose_id": 2,
        "type": "Residencial",
        "type_id": 1,
        "subtype": "Departamento",
        "subtype_id": 1,
        "price": 120000,
        "currency": "MXN",
        "bedrooms": 3,
        "bathrooms": 3,
        "built_area_m2": 315,
        "parking_spaces": 2,
        "latitude": 19.4303847,
        "longitude": -99.1868662,
        "address": {
          "state": "DF / CDMX",
          "city": "Miguel Hidalgo",
          "municipality": "Miguel Hidalgo",
          "colony": "Polanco IV Sección",
          "zipcode": "11550",
          "street": "ANDRES BELLO",
          "full_address": "ANDRES BELLO, Col. Polanco IV Sección C.P. 11550, Miguel Hidalgo"
        },
        "thumbnail": "https://propiedadescom.s3.amazonaws.com/files/292x200/DF-CDMX-Polanco-IV-Seccion-ANDRES-BELLO-Miguel-Hidalgo-0-31841566.jpeg",
        "photo_count": 28,
        "published_at": "2026-10-09 00:21:45",
        "modified_at": "19/10/2026",
        "days_listed_label": "1 mes en Propiedades.com",
        "flags": {
          "new": false,
          "exclusive": false,
          "auction": false,
          "highlighted": true,
          "off_market": false,
          "showroom": false,
          "whatsapp_verified": true
        },
        "amenities": {
          "basement": false,
          "fireplace": false,
          "cistern": true,
          "furnished": false,
          "gym": false,
          "heating": false,
          "laundry_area": false,
          "natural_gas": false,
          "pets_allowed": false,
          "pool": false,
          "private_security": true,
          "service_room": true,
          "terrace": true,
          "elevator": true,
          "loading_docks": false,
          "air_conditioning": false,
          "cctv": false,
          "emergency_plan": false,
          "optical_fiber": false,
          "telephony": false,
          "surveillance": false,
          "electricity": false,
          "fire_system": false,
          "truck_scale": false,
          "ventilation": false,
          "lighting": false
        }
      }
    ],
    "excluded_by_filters": 6,
    "pagination": {
      "page": 1,
      "per_page": 47,
      "total_items": 616,
      "total_pages": 14,
      "next_page": 2
    },
    "location": {
      "id": "150028",
      "label": "Zona Polanco, Ciudad de México / CDMX",
      "state": "Ciudad de México / CDMX",
      "city": "Zona Polanco"
    }
  },
  "meta": {
    "endpoint_family": "search",
    "request_id": "req_1c2219ba0f084ff8add4b6a8d2be8f5d",
    "credits_charged": 1,
    "credits_remaining": 1822
  }
}
```

200 OK JSON X-Credits-Used: 1

Recorded from our API and shortened.

[Run this endpoint in the playground](https://perceptlayer.com/apis/propiedades-com?try=search#playground) with your own parameters. 1 credit per successful call; failed calls are free.
