Properati Listing API returns one listing by the id from the search route. It has the price in COP, the administration fee, bedrooms, bathrooms, car spaces, area, stratum, construction year, floor, the full description, facilities (grouped), all photos, exact coordinates, the breadcrumb and the publishing agency with a link to its profile.
Good to know:
- Colombia only. Rent prices are per month. A number the listing does not show is
null, never 0. - The detail needs two lookups on Properati: the page and the listing data. If the listing data is not available, you still get the page data with bedrooms, bathrooms, car spaces and coordinates set to
null, andmeta.partialistrue. - An unknown id, an expired listing or a development id returns 404 and is not billed.
- Phone numbers are not returned.
- Failures are never billed.
Run this endpoint
Endpoint
Parameters
Start with the required fields, then add optional filters only when your use case needs them.
Runnable path
1 required parameter needed before sending a request.
string
Required
Listing id from the search route. Example: 01a093a9-d7c1-78bb-b5d1-486b76e9cd17.
1234567890
Response Schema
Example response fields are illustrative; inspect the JSON before integrating.
Example response fields
Scan these fields before integrating.
data
meta
success
{
"data": {
"listing": {
"id": "01a093a9-d7c1-78bb-b5d1-486b76e9cd17",
"url": "https://www.properati.com.co/detalle/14032-32-d7e1-486b76e9cd37-1a093c9-b5f1-78db",
"area": {
"unit": "m2",
"value": 143
},
"floor": 4,
"price": {
"amount": 1200000000,
"period": null,
"currency": "COP",
"formatted": "$ 1.200.000.000"
},
"title": "APARTAMENTO EN VENTA MEDELL\u00cdN EL POBLADO 143 M2",
"agency": {
"id": "14032-32-6171-4798f77a51d9-1a05ddd-9597-702c",
"url": "https://www.properati.com.co/inmobiliaria/14032-32-6171-4798f77a51d9-1a05ddd-9597-702c",
"name": "Mar\u00eda Cristina Ochoa U.",
"logo_url": "https://images.proppit.com/publisher/01a05dbd-6151-700c-9577-4798f77a51b9/logo.jpeg",
"is_premium": true
},
"images": [
"https://img.properati.com/eyJidWNrZXQiOiJwcmQtbGlmdWxsY29ubmVjdC1iYWNrZW5kLWIyYi1pbWFnZXMiLCJrZXkiOiJpbmdlc3Rlci8wMWEwOTNhOS1kN2MxLTc4YmItYjVkMS00ODZiNzZlOWNkMTcvN2M2OGU5MWZkZThmMDliM2FjMTE4MDZkYmQyOTAwMTNhOTQxMWQ0YmViZDU5YjBhMjNhNGVkMzRjMGVlN2M0ZS5qcGVnIiwiYnJhbmQiOiJwcm9wZXJhdGkiLCJlZGl0cyI6eyJyb3RhdGUiOm51bGwsInJlc2l6ZSI6eyJ3aWR0aCI6NjUyLCJoZWlnaHQiOjQ4MCwiZml0IjoiY292ZXIifX19",
"https://img.properati.com/eyJidWNrZXQiOiJwcmQtbGlmdWxsY29ubmVjdC1iYWNrZW5kLWIyYi1pbWFnZXMiLCJrZXkiOiJpbmdlc3Rlci8wMWEwOTNhOS1kN2MxLTc4YmItYjVkMS00ODZiNzZlOWNkMTcvYmEwMTQxZjI5NTVkZTkyZDE2YmU3ZWVhMjdlNGE0YmYwMTNjZTY3Y2NmYmU0ZDNmY2ZmNTE5MjIyNzRjY2RjNC5qcGVnIiwiYnJhbmQiOiJwcm9wZXJhdGkiLCJlZGl0cyI6eyJyb3RhdGUiOm51bGwsInJlc2l6ZSI6eyJ3aWR0aCI6NjUyLCJoZWlnaHQiOjQ4MCwiZml0IjoiY292ZXIifX19"
],
"stratum": 6,
"bedrooms": 3,
"location": {
"text": "El Poblado, Medell\u00edn, Antioquia",
"is_exact": true,
"latitude": 6.196686,
"longitude": -75.566718
},
"admin_fee": {
"amount": 1173000,
"currency": "COP",
"formatted": "$ 1.173.000"
},
"bathrooms": 3,
"breadcrumb": [
{
"url": "https://www.properati.com.co/s/venta",
"name": "Venta"
},
{
"url": "https://www.properati.com.co/s/apartamento/venta",
"name": "Apartamentos"
},
{
"url": "https://www.properati.com.co/s/antioquia-colombia/apartamento/venta",
"name": "Antioquia"
},
{
"url": "https://www.properati.com.co/s/medellin-antioquia/apartamento/venta",
"name": "Medell\u00edn"
},
{
"url": "https://www.properati.com.co/s/el-poblado-medellin/apartamento/venta",
"name": "El Poblado"
}
],
"car_spaces": null,
"facilities": [
"Balc\u00f3n",
"Cuarto de servicio",
"Permite mascotas",
"Cocina integral",
"Gas natural",
"Piscina",
"Vigilante",
"Ascensor"
],
"description": "VENDO APARTAMENTO EN MEDELL\u00cdN EN EL POBLADO\nValor: $1200 millones\nArea: 143 m2 construidos \nSi quieres vivir en un apartamento parte baja de El Poblado, con espacios generosos, que puedas salir a caminar, con iglesia cercana, \u00e9sta es tu opo...",
"image_count": 13,
"listing_type": "sale",
"published_at": "2026-09-12",
"property_type": "apartamento",
"published_text": "12 sept 2026",
"publisher_name": "Mar\u00eda Cristina Ochoa U.",
"facility_groups": [
{
"group": "Caracter\u00edsticas de la propiedad",
"items": [
"Balc\u00f3n",
"Cuarto de servicio",
"Permite mascotas",
"Cocina integral",
"Gas natural"
]
},
{
"group": "Caracter\u00edsticas del edificio",
"items": [
"Piscina",
"Vigilante",
"Ascensor"
]
}
],
"construction_year": 1996
}
},
"meta": {
"billable": true,
"endpoint_family": "listing"
},
"success": true
}Errors
Handle these documented responses before retrying or showing customer-facing failures.
Validation Error
The id is missing or has an invalid format. This response is not billable.
{
"errors": {
"q": [
"The q field is required."
]
},
"message": "The request validation failed"
}Not Found
No listing exists for this id, or the listing expired. This response is not billable.
{
"meta": {
"billable": false,
"retryable": false,
"endpoint_family": "listing"
},
"error": {
"code": "NOT_FOUND",
"message": "The requested resource was not found."
},
"success": false
}Upstream Unavailable
Properati could not be reached, or returned a page that does not match the expected shape. Retry shortly. This response is not billable.
{
"meta": {
"billable": false,
"retryable": true,
"endpoint_family": "listing"
},
"error": {
"code": "UPSTREAM_UNAVAILABLE",
"message": "Properati could not be reached. Please retry shortly."
},
"success": false
}Generate Code with AI
Copy a ready-made prompt with all the endpoint details, parameters, and example responses. Paste it into ChatGPT, Claude, or any AI assistant to instantly generate working code.
Try It Live
Test this endpoint in our interactive playground with real data.