--- title: "Encuentra24 API: JSON data, 5 endpoints, 1 credit per call" description: "Encuentra24 API for property search, listings, agents and property types in Costa Rica, Panama, Nicaragua and Honduras as JSON. 1 credit per successful call." url: https://perceptlayer.com/apis/encuentra24 --- [APIs](https://perceptlayer.com/apis) / [Real estate](https://perceptlayer.com/verticals/real-estate) / Encuentra24 1 credit per call 5 endpoints 25 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 key](https://perceptlayer.com/signup) Run 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 OK JSON X-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. | # | id string | title string | url url | listing\_type string | property\_type object | description string | price object | maintenance\_fee object | price\_per\_m2 object | location object | bedrooms integer | bathrooms number | built\_area\_m2 integer | lot\_area\_m2 number | parking\_spaces integer | floor\_type string | pet\_friendly boolean | balcony string | media object | agent object | featured\_tier string | is\_reposted boolean | posted\_at string | updated\_at string | renewed\_until string | | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | 1 | 33073375 | Casa con habitación en primer nivel, condominio en La Uruca | https://www.encuentra24.com/costa-rica-es/bienes-raices-venta-de-propiedades-casas/casa-con-habitacion-en-primer-nivel-condominio-en-la-uruca/33073375 | sale | {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} | 4 | 3.5 | 240 | 187 | 2 | Cerámica | true | Terraza | {2 fields} | {6 fields} | platinum | true | 2026-11-12T12:59:59.000Z | 2026-11-12T12:59:59.000Z | 2026-11-13T12:55:02Z | | 2 | 33252868 | Venta de Casa en Condominio Hacienda La Rivera, Belén, Heredia \| Piscina, Casa Club, Áreas Verdes y Seguridad 24/7 | 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 | sale | {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} | 3 | 2.5 | 158 | 102 | 2 | Otro | true | Terraza | {2 fields} | {6 fields} | platinum | true | 2026-11-12T03:49:59.000Z | 2026-11-12T03:49:59.000Z | 2026-11-13T03:45:02Z | | 3 | 33208182 | Vendo Casa Hatillo 6 | https://www.encuentra24.com/costa-rica-es/bienes-raices-venta-de-propiedades-casas/vendo-casa-hatillo-6/33208182 | sale | {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} | 3 | 2 | 219 | 219.66 | 2 | — | true | Terraza | {2 fields} | {6 fields} | platinum | true | 2026-11-12T02:59:59.000Z | 2026-11-12T02:59:59.000Z | 2026-11-13T02:56:08Z | Recorded from our API · 3 items shown · 25 datapoints per item GET /v1/encuentra24/search?country=costa-rica&listing\_type=sale&max\_price=300000&min\_bedrooms=3 25 datapoints ### Identity - id string - title string - listing\_type string - property\_type object - floor\_type string ### Contact - url url - agent object ### Location - location object - built\_area\_m2 integer - lot\_area\_m2 number ### Price - price object - maintenance\_fee object - price\_per\_m2 object ### Other - description string - bedrooms integer - bathrooms number - parking\_spaces integer - pet\_friendly boolean - balcony string - media object - featured\_tier string - is\_reposted boolean - posted\_at string - updated\_at string - renewed\_until string Playground ## Run this API cURL shell ``` 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. | Endpoint | Required parameters | Cost | | --- | --- | --- | | [GET `/v1/encuentra24/agent`](https://perceptlayer.com/apis/encuentra24/agent) | `id` +2 optional | 1 credit | | [GET `/v1/encuentra24/autocomplete`](https://perceptlayer.com/apis/encuentra24/autocomplete) | `query` +2 optional | 1 credit | | [GET `/v1/encuentra24/listing`](https://perceptlayer.com/apis/encuentra24/listing) | none +3 optional | 1 credit | | [GET `/v1/encuentra24/property-types`](https://perceptlayer.com/apis/encuentra24/property-types) | none +1 optional | 1 credit | | [GET `/v1/encuentra24/search`](https://perceptlayer.com/apis/encuentra24/search) | none +16 optional | 1 credit | Overview ## About the Encuentra24 API ## 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 estate JSON REST MCP ### More real estate APIs [28Hse](https://perceptlayer.com/apis/28hse) [4zida](https://perceptlayer.com/apis/4zida) [591](https://perceptlayer.com/apis/591-house) [99.co](https://perceptlayer.com/apis/99co) [99acres](https://perceptlayer.com/apis/99acres) [Adondevivir](https://perceptlayer.com/apis/adondevivir) [Apartment List](https://perceptlayer.com/apis/apartment-list) [Apartments.com](https://perceptlayer.com/apis/apartments-com) [Aqar](https://perceptlayer.com/apis/aqar) [Aqarmap](https://perceptlayer.com/apis/aqarmap) [Argenprop](https://perceptlayer.com/apis/argenprop) [athome](https://perceptlayer.com/apis/athome) 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 key](https://perceptlayer.com/signup) [Read the docs](https://docs.perceptlayer.com)