APIs / Encuentra24 / Search

Encuentra24: Search

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

GET /v1/encuentra24/search

Parameters

Send parameters in the query string.

ParameterTypeRequiredAllowed values
countrystringOptionalcosta-rica, panama, nicaragua, honduras
listing_typestringOptionalsale, rent
property_typestringOptionalapartamentos, casas, edificios, fincas, negocios, oficinas, casas-de-playa, casas-en-el-interior, comercios, cuartos, estacionamientos-sepultura-otros, lotes-y-terrenos
regionstringOptionalUp to 150 characters
keywordstringOptionalUp to 80 characters
min_pricenumberOptionalAny
max_pricenumberOptionalAny
min_bedroomsintegerOptionalAny
max_bedroomsintegerOptionalAny
min_bathroomsintegerOptionalAny
max_bathroomsintegerOptionalAny
min_areaintegerOptionalAny
max_areaintegerOptionalAny
posted_within_daysintegerOptional1, 3, 7, 30
sortstringOptionalrelevance, price_asc, price_desc, newest
pageintegerOptionalAny

Example request

Encuentra24
GET/v1/encuentra24/search?country=costa-rica&listing_type=sale&max_price=300000&min_bedrooms=3
{
  "success": true,
  "data": {
    "applied_filters": {
      "country": "costa-rica",
      "listing_type": "sale",
      "sort": "relevance",
      "max_price": 300000,
      "min_bedrooms": 3
    },
    "pagination": {
      "page": 1,
      "per_page": 20,
      "total_results": 3103,
      "total_pages": 156,
      "has_next_page": true,
      "filtered_out": 0
    },
    "items": [
      {
        "id": "33073375",
        "title": "Casa con habitación en primer nivel, condominio en La Uruca",
        "url": "https://www.encuentra24.com/costa-rica-es/bienes-raices-venta-de-propiedades-casas/casa-con-habitacion-en-primer-nivel-condominio-en-la-uruca/33073375",
        "listing_type": "sale",
        "property_type": {
          "slug": "casas",
          "label": "Casa"
        },
        "description": "Casa en condominio | La Uruca, detrás del Hospital México\n\n\n\nUbicación estratégica, espacios funcionales y una excelente oportunidad de inversión.\n\n\n\nSi buscas una casa en una zona céntrica, con fácil acceso y cerca de importantes centros d…",
        "price": {
          "amount": 185000,
          "currency": "USD",
          "symbol": "$"
        },
        "maintenance_fee": {
          "amount": 112000,
          "currency": "CRC"
        },
        "price_per_m2": {
          "total_area": 989.3048128342245,
          "built_area": 770.8333333333334
        },
        "location": {
          "exact_address": "San José, La Uruca, Costa Rica",
          "locality": "San José provincia",
          "region": "San José provincia",
          "latitude": 9.764317,
          "longitude": -84.13435,
          "map_marker_hidden": false
        },
        "bedrooms": 4,
        "bathrooms": 3.5,
        "built_area_m2": 240,
        "lot_area_m2": 187,
        "parking_spaces": 2,
        "floor_type": "Cerámica",
        "pet_friendly": true,
        "balcony": "Terraza",
        "media": {
          "main_image": "https://photos.encuentra24.com/t_or_fh_m/f_auto/v1/cr/33/07/33/75/33073375_4e0b525",
          "images": [
            "https://photos.encuentra24.com/t_or_fh_m/f_auto/v1/cr/33/07/33/75/33073375_4e0b525",
            "https://photos.encuentra24.com/t_or_fh_m/f_auto/v1/cr/33/07/33/75/33073375_008637f",
            "https://photos.encuentra24.com/t_or_fh_m/f_auto/v1/cr/33/07/33/75/33073375_1b10122"
          ]
        },
        "agent": {
          "id": "2874230",
          "name": "Carré Bienes Raíces",
          "verified": false,
          "avatar": "https://photos.encuentra24.com/t_user_logo/v1/users/logo/28/74/23/2874230_c83d19",
          "type": "Agente",
          "profile_url": "https://www.encuentra24.com/costa-rica-es/user/profile/id/2874230"
        },
        "featured_tier": "platinum",
        "is_reposted": true,
        "posted_at": "2026-11-12T12:59:59.000Z",
        "updated_at": "2026-11-12T12:59:59.000Z",
        "renewed_until": "2026-11-13T12:55:02Z"
      },
      {
        "id": "33252868",
        "title": "Venta de Casa en Condominio Hacienda La Rivera, Belén, Heredia | Piscina, Casa Club, Áreas Verdes y Seguridad 24/7",
        "url": "https://www.encuentra24.com/costa-rica-es/bienes-raices-venta-de-propiedades-casas/venta-de-casa-en-condominio-hacienda-la-rivera-belen-heredia-piscina-casa-club-areas-verdes-y-seguridad-24-7/33252868",
        "listing_type": "sale",
        "property_type": {
          "slug": "casas",
          "label": "Casa"
        },
        "description": "# Moderna Casa en Condominio con Amenidades y Seguridad 24/7\n\n\n\nDisfrute de la comodidad, privacidad y tranquilidad de vivir en un exclusivo condominio, con una excelente ubicación cerca de importantes centros empresariales, comercios, supe…",
        "price": {
          "amount": 230000,
          "currency": "USD",
          "symbol": "$"
        },
        "price_per_m2": {
          "total_area": 2254.901960784314,
          "built_area": 1455.6962025316457
        },
        "location": {
          "exact_address": "Heredia, Belén, Costa Rica",
          "locality": "Heredia provincia, Belén",
          "region": "Belén",
          "latitude": 9.979719,
          "longitude": -84.180435,
          "map_marker_hidden": false
        },
        "bedrooms": 3,
        "bathrooms": 2.5,
        "built_area_m2": 158,
        "lot_area_m2": 102,
        "parking_spaces": 2,
        "stories": 2,
        "floor_type": "Otro",
        "swimming_pool": true,
        "pet_friendly": true,
        "balcony": "Terraza",
        "media": {
          "main_image": "https://photos.encuentra24.com/t_or_fh_m/f_auto/v1/cr/33/25/28/68/33252868_ec67a74",
          "images": [
            "https://photos.encuentra24.com/t_or_fh_m/f_auto/v1/cr/33/25/28/68/33252868_ec67a74",
            "https://photos.encuentra24.com/t_or_fh_m/f_auto/v1/cr/33/25/28/68/33252868_033b743",
            "https://photos.encuentra24.com/t_or_fh_m/f_auto/v1/cr/33/25/28/68/33252868_85ffc7c"
          ]
        },
        "agent": {
          "id": "161692",
          "name": "Laura Gomez",
          "verified": false,
          "avatar": "https://photos.encuentra24.com/t_user_logo/v1/users/logo/16/16/92/161692_0ee3cf",
          "type": "Agente",
          "profile_url": "https://www.encuentra24.com/costa-rica-es/user/profile/id/161692"
        },
        "featured_tier": "platinum",
        "badge": "Exclusivo",
        "is_reposted": true,
        "posted_at": "2026-11-12T03:49:59.000Z",
        "updated_at": "2026-11-12T03:49:59.000Z",
        "renewed_until": "2026-11-13T03:45:02Z"
      },
      {
        "id": "33208182",
        "title": "Vendo Casa Hatillo 6",
        "url": "https://www.encuentra24.com/costa-rica-es/bienes-raices-venta-de-propiedades-casas/vendo-casa-hatillo-6/33208182",
        "listing_type": "sale",
        "property_type": {
          "slug": "casas",
          "label": "Casa"
        },
        "description": "Se presenta una atractiva casa en venta ubicada en Hatillo 6, San José, con un precio de 80,000,000 CRC. Esta propiedad se asienta sobre un terreno de 219,66 m² y destaca por su diseño de una sola planta, que ofrece comodidad, amplitud y un…",
        "price": {
          "amount": 80000000,
          "currency": "CRC",
          "symbol": "₡"
        },
        "price_per_m2": {
          "total_area": 363636.36363636365,
          "built_area": 365296.803652968
        },
        "location": {
          "exact_address": "San José, Hatillo 6, Costa Rica",
          "locality": "San José provincia, San José Capital, Hatillo",
          "region": "Hatillo",
          "latitude": 9.919367,
          "longitude": -84.10986,
          "map_marker_hidden": false
        },
        "bedrooms": 3,
        "bathrooms": 2,
        "built_area_m2": 219,
        "lot_area_m2": 219.66,
        "parking_spaces": 2,
        "stories": 1,
        "pet_friendly": true,
        "balcony": "Terraza",
        "media": {
          "main_image": "https://photos.encuentra24.com/t_or_fh_m/f_auto/v1/cr/33/20/81/82/33208182_956e7b0",
          "images": [
            "https://photos.encuentra24.com/t_or_fh_m/f_auto/v1/cr/33/20/81/82/33208182_956e7b0",
            "https://photos.encuentra24.com/t_or_fh_m/f_auto/v1/cr/33/20/81/82/33208182_cc390a0",
            "https://photos.encuentra24.com/t_or_fh_m/f_auto/v1/cr/33/20/81/82/33208182_8c4b09b"
          ]
        },
        "agent": {
          "id": "748749",
          "name": "Marjorie Méndez",
          "verified": false,
          "avatar": "https://photos.encuentra24.com/t_user_logo/v1/users/logo/74/87/49/748749_1ca615",
          "type": "Agente",
          "profile_url": "https://www.encuentra24.com/costa-rica-es/user/profile/id/748749"
        },
        "featured_tier": "platinum",
        "is_reposted": true,
        "posted_at": "2026-11-12T02:59:59.000Z",
        "updated_at": "2026-11-12T02:59:59.000Z",
        "renewed_until": "2026-11-13T02:56:08Z"
      }
    ],
    "notices": [
      "Price filters and the price sort compare a USD-equivalent value. Each item shows its own price in its own currency, so a price in colones can sit next to a price in dollars."
    ]
  },
  "meta": {
    "endpoint_family": "search",
    "request_id": "req_19f15404fd9c4289bf90c351d6612637",
    "credits_charged": 1,
    "credits_remaining": 1873
  }
}
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.