APIs / Properati / Search

Properati: Search

Search from Properati as JSON. 1 credit per successful call.

GET /v1/properati/search

Parameters

Send parameters in the query string.

ParameterTypeRequiredAllowed values
locationstringRequiredAny
operationstringOptionalventa, arriendo, sale, rent
property_typestringOptionalapartamento, casa, apartaestudio, oficina, local, parqueadero
stratumstringOptionalAny
days_since_publicationintegerOptional1, 7, 30
sortstringOptionalrelevance, published_on_desc, price_asc, price_desc, surface_total_desc, surface_total_asc
pageintegerOptionalAny
min_priceintegerOptionalAny
max_priceintegerOptionalAny
bedroomsintegerOptionalAny
bathroomsintegerOptionalAny
min_usable_areaintegerOptionalAny
max_usable_areaintegerOptionalAny
min_built_areaintegerOptionalAny
max_built_areaintegerOptionalAny

Example request

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.

Run this endpoint in the playground with your own parameters. 1 credit per successful call; failed calls are free.