Sign inGet a free API keyDashboard
Menu

APIs / Real estate / Propiedades.com

1 credit per call3 endpoints25 datapoints

Propiedades.com API

Propiedades.com API for Mexican homes and commercial property for sale or rent, with prices, areas and amenities as JSON. 1 credit per successful call.

Get a free API keyRun it below
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 OKJSONX-Credits-Used: 1
Recorded from our API and shortened.

Sample data

What one call returns

A recorded run of search: the fields and shapes you will get, shortened to 3 items.

#idintegerurlurltitlestringpurposestringpurpose_idintegertypestringtype_idintegersubtypestringsubtype_idintegerpriceintegercurrencystringbedroomsintegerbathroomsintegerbuilt_area_m2integerparking_spacesnumberlatitudenumberlongitudenumberaddressobjectthumbnailurlphoto_countintegerpublished_atstringmodified_atstringdays_listed_labelstringflagsobjectamenitiesobject
131727116https://propiedades.com/inmuebles/departamento-en-renta-galileo-polanco-iv-seccion-df-31727116Departamento en renta Galileo, Col. Polanco IV SecciónRenta2Residencial1Departamento158500MXN34155219.4303847-99.1868662{7 fields}https://propiedadescom.s3.amazonaws.com/files/292x200/DF-CDMX-Polanco-IV-Seccion-Galileo-Miguel-Hidalgo-0-31727116.jpeg192026-09-01 02:16:2421/10/20262 meses en Propiedades.com{7 fields}{26 fields}
231422621https://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-31422621Departamento 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ónRenta2Residencial1Departamento175000MXN34297—19.4297602-99.203929{7 fields}https://propiedadescom.s3.amazonaws.com/files/292x200/4a688859-5f68-11f1-8317-bd14b34a4ab1.jpeg172026-06-03 16:19:0611/11/20265 meses en Propiedades.com{7 fields}{26 fields}
331841566https://propiedades.com/inmuebles/departamento-en-renta-andres-bello-polanco-iv-seccion-df-31841566Departamento en renta ANDRES BELLO, Col. Polanco IV SecciónRenta2Residencial1Departamento1120000MXN33315219.4303847-99.1868662{7 fields}https://propiedadescom.s3.amazonaws.com/files/292x200/DF-CDMX-Polanco-IV-Seccion-ANDRES-BELLO-Miguel-Hidalgo-0-31841566.jpeg282026-10-09 00:21:4519/10/20261 mes en Propiedades.com{7 fields}{26 fields}

Recorded from our API · 3 items shown · 25 datapoints per itemGET /v1/propiedades-com/search?purpose=rent&subtype=apartments&location_id=150028&bedrooms=3

25 datapoints

Identity

  • idinteger
  • titlestring
  • purpose_idinteger
  • typestring
  • type_idinteger
  • subtypestring
  • subtype_idinteger

Contact

  • urlurl

Location

  • built_area_m2integer
  • latitudenumber
  • longitudenumber
  • addressobject

Reputation

  • photo_countinteger

Price

  • priceinteger
  • currencystring

Other

  • purposestring
  • bedroomsinteger
  • bathroomsinteger
  • parking_spacesnumber
  • thumbnailurl
  • published_atstring
  • modified_atstring
  • days_listed_labelstring
  • flagsobject
  • amenitiesobject

Playground

Run this API

cURLshell
curl "https://api.perceptlayer.com/v1/propiedades-com/search?purpose=rent&subtype=apartments&location_id=150028&bedrooms=3" \
  -H "X-API-Key: $API_KEY"

Propiedades.com · 3 endpoints

Endpoints

Every endpoint takes the same key. Open one for its parameters and an example request.

EndpointRequired parametersCost
GET/v1/propiedades-com/autocomplete
q+3 optional
1 credit
GET/v1/propiedades-com/listing
url
1 credit
GET/v1/propiedades-com/search
location_id+13 optional
1 credit

Overview

What you can get

The Propiedades.com API returns Propiedades.com property data as JSON through 3 endpoints.

  • Search: search takes a location_id, with purpose (sale, rent or both), type (residential, commercial or industrial), subtype, price_min, price_max, size_min, size_max, bedrooms, bathrooms, auctions, amenities[] (repeatable), sort (price_asc, price_desc, bedrooms_asc or bedrooms_desc) and page.
  • Listings: listing takes a Propiedades.com url.
  • Autocomplete: autocomplete takes a q, with purpose, type and subtype.

The recorded search for three-bedroom apartments to rent in location 150028 (Zona Polanco, Mexico City) returns items with id, url, title, purpose, type, subtype, price, currency, bedrooms, bathrooms, built_area_m2, parking_spaces, latitude, longitude, address, thumbnail, photo_count, published_at, modified_at, days_listed_label, flags and amenities. It also returns pagination with per_page, total_items (616), total_pages and next_page, and the location searched.

How a call works

Search a neighbourhood: GET /v1/propiedades-com/search?purpose=rent&subtype=apartments&location_id=150028&bedrooms=3 with your key in the X-API-Key header. Each item's url is what listing takes. Use autocomplete with a q such as polanco to look up a place. Every successful call costs 1 credit; failed calls cost nothing.

Real estateJSONRESTMCP

More real estate APIs

28Hse4zida59199.co99acresAdondevivirApartment ListApartments.comAqarAqarmapArgenpropathome

Use cases

Track asking rents and sale prices in Polanco or another Mexico City neighbourhood

Use the Propiedades.com API to track asking rents and sale prices in Polanco or another Mexico City neighbourhood

Compare price per `built_area_m2` across a city

Use the Propiedades.com API to compare price per `built_area_m2` across a city

Watch property auctions with `auctions`

Use the Propiedades.com API to watch property auctions with `auctions`

Filter by amenities with `amenities[]`

Use the Propiedades.com API to filter by amenities with `amenities[]`

FAQ

Questions

Do I need a Propiedades.com account?

No. You call this Propiedades.com API with your Perceptlayer key in the `X-API-Key` header, with no Propiedades.com login.

How much does the Propiedades.com API cost?

Each successful call costs one credit. New accounts get free credits to start, and credit packs bring the price down as you scale.

What format are responses in?

Every endpoint returns JSON, with no HTML parsing on your side.

Can I search sale and rent together?

Yes. Set `purpose=both` on `search` or `autocomplete`.

Should I build a Propiedades.com scraper instead?

You can, but a Propiedades.com scraper is code you maintain: page changes break it, requests get blocked, and Propiedades.com's terms govern how you collect data. The Propiedades.com API gives you 3 endpoints of named JSON fields for 1 credit per successful call, and failed calls cost nothing. A scraper makes sense only for data these endpoints don't return, so check the response in the playground on this page first.

Try the Propiedades.com API with 100 free credits

No credit card. Failed calls are never billed.

Get a free API keyRead the docs