--- title: "Propiedades.com API: 3 endpoints, 1 credit per call" description: "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." url: https://perceptlayer.com/apis/propiedades-com --- [APIs](https://perceptlayer.com/apis) / [Real estate](https://perceptlayer.com/verticals/real-estate) / Propiedades.com 1 credit per call 3 endpoints 25 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 key](https://perceptlayer.com/signup) Run 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 OK JSON X-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. | # | id integer | url url | title string | purpose string | purpose\_id integer | type string | type\_id integer | subtype string | subtype\_id integer | price integer | currency string | bedrooms integer | bathrooms integer | built\_area\_m2 integer | parking\_spaces number | latitude number | longitude number | address object | thumbnail url | photo\_count integer | published\_at string | modified\_at string | days\_listed\_label string | flags object | amenities object | | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | 1 | 31727116 | https://propiedades.com/inmuebles/departamento-en-renta-galileo-polanco-iv-seccion-df-31727116 | Departamento en renta Galileo, Col. Polanco IV Sección | Renta | 2 | Residencial | 1 | Departamento | 1 | 58500 | MXN | 3 | 4 | 155 | 2 | 19.4303847 | \-99.1868662 | {7 fields} | https://propiedadescom.s3.amazonaws.com/files/292x200/DF-CDMX-Polanco-IV-Seccion-Galileo-Miguel-Hidalgo-0-31727116.jpeg | 19 | 2026-09-01 02:16:24 | 21/10/2026 | 2 meses en Propiedades.com | {7 fields} | {26 fields} | | 2 | 31422621 | 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 | 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 | Renta | 2 | Residencial | 1 | Departamento | 1 | 75000 | MXN | 3 | 4 | 297 | — | 19.4297602 | \-99.203929 | {7 fields} | https://propiedadescom.s3.amazonaws.com/files/292x200/4a688859-5f68-11f1-8317-bd14b34a4ab1.jpeg | 17 | 2026-06-03 16:19:06 | 11/11/2026 | 5 meses en Propiedades.com | {7 fields} | {26 fields} | | 3 | 31841566 | https://propiedades.com/inmuebles/departamento-en-renta-andres-bello-polanco-iv-seccion-df-31841566 | Departamento en renta ANDRES BELLO, Col. Polanco IV Sección | Renta | 2 | Residencial | 1 | Departamento | 1 | 120000 | MXN | 3 | 3 | 315 | 2 | 19.4303847 | \-99.1868662 | {7 fields} | https://propiedadescom.s3.amazonaws.com/files/292x200/DF-CDMX-Polanco-IV-Seccion-ANDRES-BELLO-Miguel-Hidalgo-0-31841566.jpeg | 28 | 2026-10-09 00:21:45 | 19/10/2026 | 1 mes en Propiedades.com | {7 fields} | {26 fields} | Recorded from our API · 3 items shown · 25 datapoints per item GET /v1/propiedades-com/search?purpose=rent&subtype=apartments&location\_id=150028&bedrooms=3 25 datapoints ### Identity - id integer - title string - purpose\_id integer - type string - type\_id integer - subtype string - subtype\_id integer ### Contact - url url ### Location - built\_area\_m2 integer - latitude number - longitude number - address object ### Reputation - photo\_count integer ### Price - price integer - currency string ### Other - purpose string - bedrooms integer - bathrooms integer - parking\_spaces number - thumbnail url - published\_at string - modified\_at string - days\_listed\_label string - flags object - amenities object Playground ## Run this API cURL shell ``` 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. | Endpoint | Required parameters | Cost | | --- | --- | --- | | [GET `/v1/propiedades-com/autocomplete`](https://perceptlayer.com/apis/propiedades-com/autocomplete) | `q` +3 optional | 1 credit | | [GET `/v1/propiedades-com/listing`](https://perceptlayer.com/apis/propiedades-com/listing) | `url` | 1 credit | | [GET `/v1/propiedades-com/search`](https://perceptlayer.com/apis/propiedades-com/search) | `location_id` +13 optional | 1 credit | Overview ## About the Propiedades.com API ## 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 estate JSON REST MCP ### More real estate APIs [28Hse](https://perceptlayer.com/apis/28hse) [4zida](https://perceptlayer.com/apis/4zida) [591](https://perceptlayer.com/apis/591-house) [99.co](https://perceptlayer.com/apis/99co) [99acres](https://perceptlayer.com/apis/99acres) [Adondevivir](https://perceptlayer.com/apis/adondevivir) [Apartment List](https://perceptlayer.com/apis/apartment-list) [Apartments.com](https://perceptlayer.com/apis/apartments-com) [Aqar](https://perceptlayer.com/apis/aqar) [Aqarmap](https://perceptlayer.com/apis/aqarmap) [Argenprop](https://perceptlayer.com/apis/argenprop) [athome](https://perceptlayer.com/apis/athome) 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 key](https://perceptlayer.com/signup) [Read the docs](https://docs.perceptlayer.com)