Properati Agency API returns an agency profile by the agency id from the listing route: name, logo, premium status, total listings, the year it started publishing and a page of its listings for sale or for rent. Each listing has the price, location text, bedrooms, bathrooms, area, publish date and photos. Use the listing id from units[].id with the listing route for full detail.
Good to know:
- Each page has up to 6 listings.
pagination.totalis the number of listings in the chosen operation. - The first page for sale needs one lookup on Properati. Other pages and rent listings need two.
- Phone numbers and email addresses are not returned.
- An unknown agency id returns 404 and is not billed. A page past the end returns an empty list.
- 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.
2 optional filters available.
string
Required
Agency id from the listing route (agency.id).
1234567890
string
Optional
venta (for sale, default) or arriendo (for rent).
example
integer
Optional
One-based page of the agency listings (default 1, 6 per page).
1
Response Schema
Example response fields are illustrative; inspect the JSON before integrating.
Example response fields
Scan these fields before integrating.
data
meta
success
{
"data": {
"units": [
{
"id": "14032-32-c21e-e0c588700195-fa411e9c-a696-4ab8",
"url": "https://www.properati.com.co/detalle/14032-32-c21e-e0c588700195-fa411e9c-a696-4ab8",
"area": {
"unit": "m2",
"value": 67
},
"price": {
"amount": 520000000,
"currency": "COP",
"formatted": "$ 520.000.000"
},
"title": "Apartamento en venta en Sabaneta",
"images": [
"https://img.properati.com/eyJidWNrZXQiOiJwcmQtbGlmdWxsY29ubmVjdC1iYWNrZW5kLWIyYi1pbWFnZXMiLCJrZXkiOiJpbmdlc3Rlci9mYTQxMWU3Yy1jMWZlLTRhOTgtYTY3Ni1lMGM1ODg3MDAxNzUvNTcwMjA0MjgyMGQyMWJhZDg5ZjM0NThlMTQyZjc1NzJhOGJkNTg3ZjVjM2ViYzRlN2U1YTA5NjNiM2QzZTM2NS5qcGVnIiwiYnJhbmQiOiJwcm9wZXJhdGkiLCJlZGl0cyI6eyJyb3RhdGUiOm51bGwsInJlc2l6ZSI6eyJ3aWR0aCI6MzgwLCJoZWlnaHQiOjIzMCwiZml0IjoiY292ZXIifX19"
],
"bedrooms": 3,
"bathrooms": 2,
"agency_name": "Mar\u00eda Cristina Ochoa U.",
"listing_type": "sale",
"published_at": "2026-09-29",
"location_text": "Sabaneta, Antioquia",
"published_text": "29 sept 2026"
},
{
"id": "14032-32-104c-b09889137b06-a99d0f41-bbca-4ba5",
"url": "https://www.properati.com.co/detalle/14032-32-104c-b09889137b06-a99d0f41-bbca-4ba5",
"area": {
"unit": "m2",
"value": 96
},
"price": {
"amount": 790000000,
"currency": "COP",
"formatted": "$ 790.000.000"
},
"title": "Apartamento en venta en Laureles",
"images": [
"https://img.properati.com/eyJidWNrZXQiOiJwcmQtbGlmdWxsY29ubmVjdC1iYWNrZW5kLWIyYi1pbWFnZXMiLCJrZXkiOiJpbmdlc3Rlci9hOTlkMGYyMS0xMDJjLTRiODUtYmJhYS1iMDk4ODkxMzdhZTYvMzQ1OWQzNjRhYWY3NWQxNmVlYmU1MzM5Y2M3OGU3YmUzMjg5Njg2ZjgyNzRhYmVhZTM2ZGU3MGI3MjdlYTRhMi5qcGVnIiwiYnJhbmQiOiJwcm9wZXJhdGkiLCJlZGl0cyI6eyJyb3RhdGUiOm51bGwsInJlc2l6ZSI6eyJ3aWR0aCI6MzgwLCJoZWlnaHQiOjIzMCwiZml0IjoiY292ZXIifX19"
],
"bedrooms": 3,
"bathrooms": 3,
"agency_name": "Mar\u00eda Cristina Ochoa U.",
"listing_type": "sale",
"published_at": "2026-10-24T00:06:35Z",
"location_text": "Medell\u00edn, Antioquia",
"published_text": "Hace 1 d\u00eda, 18 horas"
}
],
"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,
"units_total": 26,
"background_url": "https://images.proppit.com/publisher/01a05dbd-6151-700c-9577-4798f77a51b9/backgroundImage.jpeg",
"publishing_since": 2026
},
"operation": "venta",
"pagination": {
"page": 1,
"total": 26,
"returned": 2,
"page_size": 6,
"has_next_page": true
}
},
"meta": {
"billable": true,
"endpoint_family": "agency"
},
"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, or the operation is not venta or arriendo. This response is not billable.
{
"errors": {
"q": [
"The q field is required."
]
},
"message": "The request validation failed"
}Not Found
No agency exists for this id. This response is not billable.
{
"meta": {
"billable": false,
"retryable": false,
"endpoint_family": "agency"
},
"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": "agency"
},
"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.