Sign inGet a free API keyDashboard
Menu

APIs / Real estate / Encuentra24

1 credit per call5 endpoints25 datapoints

Encuentra24 API

Encuentra24 API for property search, listings, agents and property types in Costa Rica, Panama, Nicaragua and Honduras as JSON. 1 credit per successful call.

Get a free API keyRun it below
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.

Sample data

What one call returns

A recorded run of search: the fields and shapes you will get, shortened to 3 items.

#idstringtitlestringurlurllisting_typestringproperty_typeobjectdescriptionstringpriceobjectmaintenance_feeobjectprice_per_m2objectlocationobjectbedroomsintegerbathroomsnumberbuilt_area_m2integerlot_area_m2numberparking_spacesintegerfloor_typestringpet_friendlybooleanbalconystringmediaobjectagentobjectfeatured_tierstringis_repostedbooleanposted_atstringupdated_atstringrenewed_untilstring
133073375Casa con habitación en primer nivel, condominio en La Urucahttps://www.encuentra24.com/costa-rica-es/bienes-raices-venta-de-propiedades-casas/casa-con-habitacion-en-primer-nivel-condominio-en-la-uruca/33073375sale{2 fields}Casa en condominio | La Uruca, detrás del Hospital México Ubicación estratégica, espacios funcionales y una excelente oportunidad de inversión. Si buscas una casa en una zona céntrica, con fácil acceso y cerca de importantes centros d…{3 fields}{2 fields}{2 fields}{6 fields}43.52401872CerámicatrueTerraza{2 fields}{6 fields}platinumtrue2026-11-12T12:59:59.000Z2026-11-12T12:59:59.000Z2026-11-13T12:55:02Z
233252868Venta de Casa en Condominio Hacienda La Rivera, Belén, Heredia | Piscina, Casa Club, Áreas Verdes y Seguridad 24/7https://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/33252868sale{2 fields}# Moderna Casa en Condominio con Amenidades y Seguridad 24/7 Disfrute de la comodidad, privacidad y tranquilidad de vivir en un exclusivo condominio, con una excelente ubicación cerca de importantes centros empresariales, comercios, supe…{3 fields}—{2 fields}{6 fields}32.51581022OtrotrueTerraza{2 fields}{6 fields}platinumtrue2026-11-12T03:49:59.000Z2026-11-12T03:49:59.000Z2026-11-13T03:45:02Z
333208182Vendo Casa Hatillo 6https://www.encuentra24.com/costa-rica-es/bienes-raices-venta-de-propiedades-casas/vendo-casa-hatillo-6/33208182sale{2 fields}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…{3 fields}—{2 fields}{6 fields}32219219.662—trueTerraza{2 fields}{6 fields}platinumtrue2026-11-12T02:59:59.000Z2026-11-12T02:59:59.000Z2026-11-13T02:56:08Z

Recorded from our API · 3 items shown · 25 datapoints per itemGET /v1/encuentra24/search?country=costa-rica&listing_type=sale&max_price=300000&min_bedrooms=3

25 datapoints

Identity

  • idstring
  • titlestring
  • listing_typestring
  • property_typeobject
  • floor_typestring

Contact

  • urlurl
  • agentobject

Location

  • locationobject
  • built_area_m2integer
  • lot_area_m2number

Price

  • priceobject
  • maintenance_feeobject
  • price_per_m2object

Other

  • descriptionstring
  • bedroomsinteger
  • bathroomsnumber
  • parking_spacesinteger
  • pet_friendlyboolean
  • balconystring
  • mediaobject
  • featured_tierstring
  • is_repostedboolean
  • posted_atstring
  • updated_atstring
  • renewed_untilstring

Playground

Run this API

cURLshell
curl "https://api.perceptlayer.com/v1/encuentra24/search?country=costa-rica&listing_type=sale&max_price=300000&min_bedrooms=3" \
  -H "X-API-Key: $API_KEY"

Encuentra24 · 5 endpoints

Endpoints

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

EndpointRequired parametersCost
GET/v1/encuentra24/agent
id+2 optional
1 credit
GET/v1/encuentra24/autocomplete
query+2 optional
1 credit
GET/v1/encuentra24/listing
none+3 optional
1 credit
GET/v1/encuentra24/property-types
none+1 optional
1 credit
GET/v1/encuentra24/search
none+16 optional
1 credit

Overview

What you can get

The Encuentra24 API returns Central American property data from Encuentra24 as JSON through 5 endpoints. Most take a country: costa-rica, panama, nicaragua or honduras.

  • Search: search takes country, listing_type (sale or rent), property_type (apartamentos, casas, edificios, fincas, negocios, oficinas, casas-de-playa, casas-en-el-interior, comercios, cuartos, estacionamientos-sepultura-otros or lotes-y-terrenos), region, keyword, min_price, max_price, min_bedrooms, max_bedrooms, min_bathrooms, max_bathrooms, min_area, max_area, posted_within_days (1, 3, 7 or 30), sort (relevance, price_asc, price_desc or newest) and page. property-types takes a listing_type.
  • Listings: listing takes an id or a link, with country.
  • Agents: agent takes an id, with country and page.
  • Locations: autocomplete takes a query, with country and limit.

The recorded search for homes for sale in Costa Rica up to 300,000 with at least 3 bedrooms returns data.items, each with id, title, url, listing_type, property_type, price, maintenance_fee, price_per_m2, location, bedrooms, bathrooms, built_area_m2, lot_area_m2, parking_spaces, pet_friendly, media, agent, posted_at and updated_at. It also returns pagination with total_results (3,103), total_pages and has_next_page, plus applied_filters and notices.

How a call works

Search a country: GET /v1/encuentra24/search?country=costa-rica&listing_type=sale&max_price=300000&min_bedrooms=3 with your key in the X-API-Key header. Each item's id goes to listing, and its agent carries the id that agent takes. Page with page while has_next_page is true. 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 homes and lots across four Central American countries

Use the Encuentra24 API to track asking prices for homes and lots across four Central American countries

Compare `price_per_m2` and `maintenance_fee` for apartments

Use the Encuentra24 API to compare `price_per_m2` and `maintenance_fee` for apartments

Watch new listings with `posted_within_days`

Use the Encuentra24 API to watch new listings with `posted_within_days`

Pull an agent's listings with `agent`

Use the Encuentra24 API to pull an agent's listings with `agent`

FAQ

Questions

Do I need an Encuentra24 account?

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

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

Which countries does it cover?

Set `country` to costa-rica, panama, nicaragua or honduras on `search`, `listing`, `agent` and `autocomplete`.

Should I build an Encuentra24 scraper instead?

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

No credit card. Failed calls are never billed.

Get a free API keyRead the docs