Sign inGet a free API keyDashboard
Menu

APIs / Real estate / Properati

1 credit per call4 endpoints16 datapoints

Properati API

Properati API for Colombian apartments, houses, offices and parking for sale or rent, listings and agencies as JSON. 1 credit per successful call.

Get a free API keyRun it below
Properati
GET/v1/properati/search?location=3674954&operation=venta&property_type=apartamento&bedrooms=3
{
  "success": true,
  "data": {
    "applied_filters": {
      "location": "3674954",
      "operation": "venta",
      "property_type": "apartamento",
      "bedrooms": "3",
      "sort": "relevance"
    },
    "pagination": {
      "page": 1,
      "page_size": 30,
      "returned": 30,
      "total": 8673,
      "max_page": 167,
      "capped": true,
      "has_next_page": true,
      "post_filtered": 0,
      "projects_skipped": 2
    },
    "items": [
      {
        "id": "01a093a9-d7c1-78bb-b5d1-486b76e9cd17",
        "url": "https://www.properati.com.co/detalle/14032-32-d7e1-486b76e9cd37-1a093c9-b5f1-78db",
        "title": "Apartamento en Venta en El Poblado",
        "listing_type": "sale",
        "property_type": "apartamento",
        "is_project": false,
        "price": {
          "amount": 1200000000,
          "currency": "COP",
          "formatted": "$ 1.200.000.000"
        },
        "location": {
          "text": "El Poblado, Medellín, Antioquia",
          "address": "Calle 5 Sur, Alejandría, Comuna 14 - El Poblado, Perímetro Urbano Medellín, Medellín, Valle de Aburrá, Antioquia, RAP del Agua y la Montaña, 050022, Colombia",
          "locality": "Medellín",
          "region": "Antioquia",
          "latitude": 6.196686,
          "longitude": -75.566718
        },
        "bedrooms": 3,
        "bathrooms": 3.5,
        "area": {
          "value": 143,
          "unit": "m2"
        },
        "top_amenity": "Piscina",
        "agency": {
          "name": "María Cristina Ochoa U.",
          "logo_url": "https://images.proppit.com/publisher/01a05dbd-6151-700c-9577-4798f77a51b9/logo.jpeg",
          "is_premium": true
        },
        "published_at": "2026-09-12",
        "published_text": "Publicado 12 sept 2026",
        "images": [
          "https://img.properati.com/eyJidWNrZXQiOiJwcmQtbGlmdWxsY29ubmVjdC1iYWNrZW5kLWIyYi1pbWFnZXMiLCJrZXkiOiJpbmdlc3Rlci8wMWEwOTNhOS1kN2MxLTc4YmItYjVkMS00ODZiNzZlOWNkMTcvN2M2OGU5MWZkZThmMDliM2FjMTE4MDZkYmQyOTAwMTNhOTQxMWQ0YmViZDU5YjBhMjNhNGVkMzRjMG…",
          "https://img.properati.com/eyJidWNrZXQiOiJwcmQtbGlmdWxsY29ubmVjdC1iYWNrZW5kLWIyYi1pbWFnZXMiLCJrZXkiOiJpbmdlc3Rlci8wMWEwOTNhOS1kN2MxLTc4YmItYjVkMS00ODZiNzZlOWNkMTcvYmEwMTQxZjI5NTVkZTkyZDE2YmU3ZWVhMjdlNGE0YmYwMTNjZTY3Y2NmYmU0ZDNmY2ZmNTE5MjIyNz…",
          "https://img.properati.com/eyJidWNrZXQiOiJwcmQtbGlmdWxsY29ubmVjdC1iYWNrZW5kLWIyYi1pbWFnZXMiLCJrZXkiOiJpbmdlc3Rlci8wMWEwOTNhOS1kN2MxLTc4YmItYjVkMS00ODZiNzZlOWNkMTcvNzczYmE0YmJkN2JiZjliMDlhMmY5MjZjNWRlZGE4MDk4NWViZjIwNWNiMTk1ZGM1MjY2M2M5ODBlOD…"
        ]
      },
      {
        "id": "01a0681e-0dc7-711c-99b5-c99fbc9040d8",
        "url": "https://www.properati.com.co/detalle/14032-32-de7-c99fbc9040f8-1a0683e-99d5-713c",
        "title": "Apartamento en Venta en El Poblado",
        "listing_type": "sale",
        "property_type": "apartamento",
        "is_project": false,
        "price": {
          "amount": 1200000000,
          "currency": "COP",
          "formatted": "$ 1.200.000.000"
        },
        "location": {
          "text": "El Poblado, Medellín, Antioquia",
          "address": "Carrera 43B, Patio Bonito, Comuna 14 - El Poblado, Perímetro Urbano Medellín, Medellín, Valle de Aburrá, Antioquia, RAP del Agua y la Montaña, 050022, Colombia",
          "locality": "Medellín",
          "region": "Antioquia",
          "latitude": 6.202323,
          "longitude": -75.573837
        },
        "bedrooms": 3,
        "bathrooms": 4.5,
        "area": {
          "value": 197,
          "unit": "m2"
        },
        "top_amenity": "Parqueadero",
        "agency": {
          "name": "María Cristina Ochoa U.",
          "logo_url": "https://images.proppit.com/publisher/01a05dbd-6151-700c-9577-4798f77a51b9/logo.jpeg",
          "is_premium": true
        },
        "published_at": "2026-09-03",
        "published_text": "Publicado 3 sept 2026",
        "images": [
          "https://img.properati.com/eyJidWNrZXQiOiJwcmQtbGlmdWxsY29ubmVjdC1iYWNrZW5kLWIyYi1pbWFnZXMiLCJrZXkiOiJpbmdlc3Rlci8wMWEwNjgxZS0wZGM3LTcxMWMtOTliNS1jOTlmYmM5MDQwZDgvYWQ4ZTBjODljYWEwNDdlYjNmNGRmMjA5NTk1N2NhNWRlN2Y4ZTlmMTlmYjhmZDFkZWM5MTkxZTVjMD…",
          "https://img.properati.com/eyJidWNrZXQiOiJwcmQtbGlmdWxsY29ubmVjdC1iYWNrZW5kLWIyYi1pbWFnZXMiLCJrZXkiOiJpbmdlc3Rlci8wMWEwNjgxZS0wZGM3LTcxMWMtOTliNS1jOTlmYmM5MDQwZDgvMTYzNzZiN2QxOTFhYzk0NWRiZjIwNzA1MTMxMzk1YzcxMzg5NmY5ODMzNjBkYjQ1ZWYyNzc3ODMwNW…",
          "https://img.properati.com/eyJidWNrZXQiOiJwcmQtbGlmdWxsY29ubmVjdC1iYWNrZW5kLWIyYi1pbWFnZXMiLCJrZXkiOiJpbmdlc3Rlci8wMWEwNjgxZS0wZGM3LTcxMWMtOTliNS1jOTlmYmM5MDQwZDgvZjhjNmFmMjUxZmM3YzMyZWU2MGU1ODVmNDVmMDIyOGZjOWQzODVjMWJlOWIwYWI0MWYyOGFlY2NlNT…"
        ]
      },
      {
        "id": "01a093aa-5893-7f21-b915-cdf9fd2e7309",
        "url": "https://www.properati.com.co/detalle/14032-32-58b3-cdf9fd2e7329-1a093ca-b935-7f41",
        "title": "Apartamento en Venta en El Poblado",
        "listing_type": "sale",
        "property_type": "apartamento",
        "is_project": false,
        "price": {
          "amount": 1200000000,
          "currency": "COP",
          "formatted": "$ 1.200.000.000"
        },
        "location": {
          "text": "El Poblado, Medellín, Antioquia",
          "address": "Calle 5G, La Florida, Comuna 14 - El Poblado, Perímetro Urbano Medellín, Medellín, Valle de Aburrá, Antioquia, RAP del Agua y la Montaña, 050003, Colombia",
          "locality": "Medellín",
          "region": "Antioquia",
          "latitude": 6.204194,
          "longitude": -75.564051
        },
        "bedrooms": 3,
        "bathrooms": 2,
        "area": {
          "value": 178,
          "unit": "m2"
        },
        "top_amenity": "Parqueadero",
        "agency": {
          "name": "María Cristina Ochoa U.",
          "logo_url": "https://images.proppit.com/publisher/01a05dbd-6151-700c-9577-4798f77a51b9/logo.jpeg",
          "is_premium": true
        },
        "published_at": "2026-09-12",
        "published_text": "Publicado 12 sept 2026",
        "images": [
          "https://img.properati.com/eyJidWNrZXQiOiJwcmQtbGlmdWxsY29ubmVjdC1iYWNrZW5kLWIyYi1pbWFnZXMiLCJrZXkiOiJpbmdlc3Rlci8wMWEwOTNhYS01ODkzLTdmMjEtYjkxNS1jZGY5ZmQyZTczMDkvYTE5OTc0YTc3OThmZmI3NDM2NmE4OTM1ZTFiNzE3OTkxMDk5ZTViODU1ZWZmODk5NGZkY2RmYmU0ZW…",
          "https://img.properati.com/eyJidWNrZXQiOiJwcmQtbGlmdWxsY29ubmVjdC1iYWNrZW5kLWIyYi1pbWFnZXMiLCJrZXkiOiJpbmdlc3Rlci8wMWEwOTNhYS01ODkzLTdmMjEtYjkxNS1jZGY5ZmQyZTczMDkvODk4NTYzMTQzZDVjYmFjZTA5ZGRkZWRmMDUzYjg5MWVjOTI3YjQ0YWM3OTM4OGZlNzFjYzc3M2JkZG…",
          "https://img.properati.com/eyJidWNrZXQiOiJwcmQtbGlmdWxsY29ubmVjdC1iYWNrZW5kLWIyYi1pbWFnZXMiLCJrZXkiOiJpbmdlc3Rlci8wMWEwOTNhYS01ODkzLTdmMjEtYjkxNS1jZGY5ZmQyZTczMDkvNzYwODg0ZGI5ZTE5NDc4MTliNTBjNzk5NGE1NDE0ODUyM2VlYjlmYmRmNTQ0MzgxODM0MWYxNTM2Zj…"
        ]
      }
    ]
  },
  "meta": {
    "endpoint_family": "search",
    "request_id": "req_540e44c8a93f424287d9d296f32522d7",
    "credits_charged": 1,
    "credits_remaining": 1827
  }
}
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.

#idstringurlurltitlestringlisting_typestringproperty_typestringis_projectbooleanpriceobjectlocationobjectbedroomsintegerbathroomsnumberareaobjecttop_amenitystringagencyobjectpublished_atstringpublished_textstringimagesstring[]
101a093a9-d7c1-78bb-b5d1-486b76e9cd17https://www.properati.com.co/detalle/14032-32-d7e1-486b76e9cd37-1a093c9-b5f1-78dbApartamento en Venta en El Pobladosaleapartamentofalse{3 fields}{6 fields}33.5{2 fields}Piscina{3 fields}2026-09-12Publicado 12 sept 2026[3 items]
201a0681e-0dc7-711c-99b5-c99fbc9040d8https://www.properati.com.co/detalle/14032-32-de7-c99fbc9040f8-1a0683e-99d5-713cApartamento en Venta en El Pobladosaleapartamentofalse{3 fields}{6 fields}34.5{2 fields}Parqueadero{3 fields}2026-09-03Publicado 3 sept 2026[3 items]
301a093aa-5893-7f21-b915-cdf9fd2e7309https://www.properati.com.co/detalle/14032-32-58b3-cdf9fd2e7329-1a093ca-b935-7f41Apartamento en Venta en El Pobladosaleapartamentofalse{3 fields}{6 fields}32{2 fields}Parqueadero{3 fields}2026-09-12Publicado 12 sept 2026[3 items]

Recorded from our API · 3 items shown · 16 datapoints per itemGET /v1/properati/search?location=3674954&operation=venta&property_type=apartamento&bedrooms=3

16 datapoints

Identity

  • idstring
  • titlestring
  • listing_typestring
  • property_typestring

Contact

  • urlurl

Location

  • locationobject
  • areaobject

Reputation

  • imagesstring[]

Price

  • priceobject

Other

  • is_projectboolean
  • bedroomsinteger
  • bathroomsnumber
  • top_amenitystring
  • agencyobject
  • published_atstring
  • published_textstring

Playground

Run this API

cURLshell
curl "https://api.perceptlayer.com/v1/properati/search?location=3674954&operation=venta&property_type=apartamento&bedrooms=3" \
  -H "X-API-Key: $API_KEY"

Properati · 4 endpoints

Endpoints

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

EndpointRequired parametersCost
GET/v1/properati/agency
id+2 optional
1 credit
GET/v1/properati/autocomplete
q+1 optional
1 credit
GET/v1/properati/listing
id
1 credit
GET/v1/properati/search
location+14 optional
1 credit

Overview

What you can get

The Properati API returns Properati property data as JSON through 4 endpoints.

  • Search: search takes a location, with operation (venta, arriendo, sale or rent), property_type (apartamento, casa, apartaestudio, oficina, local or parqueadero), stratum, days_since_publication (1, 7 or 30), sort (relevance, published_on_desc, price_asc, price_desc, surface_total_desc or surface_total_asc), page, min_price, max_price, bedrooms, bathrooms, min_usable_area, max_usable_area, min_built_area and max_built_area.
  • Listings: listing takes an id.
  • Agencies: agency takes an id, with operation (venta or arriendo) and page.
  • Autocomplete: autocomplete takes a q, with limit.

The recorded search for three-bedroom apartments for sale in location 3674954 (results in Medellín) returns items with id, url, title, listing_type, property_type, is_project, price, location, bedrooms, bathrooms, area, top_amenity, agency, published_at, published_text and images. It also returns pagination with page_size, max_page, capped and has_next_page, and applied_filters.

How a call works

Search a city: GET /v1/properati/search?location=3674954&operation=venta&property_type=apartamento&bedrooms=3 with your key in the X-API-Key header. Each item's id is what listing takes. Page with page up to max_page. Every successful call costs 1 credit; failed calls cost nothing.

Real estateJSONRESTMCP

More real estate APIs

28Hse4zida59199.co99acresAdondevivirApartment ListApartments.comAqarAqarmapArgenpropathome

Use cases

Track asking prices for apartments in Medellín or another Colombian city

Use the Properati API to track asking prices for apartments in Medellín or another Colombian city

Compare prices by `stratum`

Use the Properati API to compare prices by `stratum`

Watch new listings from the last day, week or month with `days_since_publication`

Use the Properati API to watch new listings from the last day, week or month with `days_since_publication`

Separate new projects from resale homes with `is_project`

Use the Properati API to separate new projects from resale homes with `is_project`

FAQ

Questions

Do I need a Properati account?

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

How much does the Properati 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.

How many results can one search return?

The recorded Medellín search reports a `max_page` of 167 at 30 per page, with `capped` set to true. Narrow the price, area, `stratum` or `property_type` to go deeper.

Should I build a Properati scraper instead?

You can, but a Properati scraper is code you maintain: page changes break it, requests get blocked, and Properati's terms govern how you collect data. The Properati API gives you 4 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 Properati API with 100 free credits

No credit card. Failed calls are never billed.

Get a free API keyRead the docs