Encuentra24 Search API returns properties for sale or for rent in Costa Rica, Panama, Nicaragua and Honduras as JSON, 20 per page. Pick a country and a listing_type, then filter by region, property type, price, bedrooms, bathrooms, built area, keyword and posting age, sort and page through the results. Every item has the price with its currency, maintenance fee, address with coordinates, bedrooms, bathrooms, built and lot area, parking, year built, features, all photos, video, floor plan, the agent and the page URL. Item url works in the listing route and agent.id in the agent route.
Filters are never ignored. Items that break a requested filter are not returned and are counted in pagination.filtered_out. A page is never labelled as another page. A page past the last one returns an empty list. Filters that are not offered, such as currency, advertiser, pool or parking, are rejected with a 422 error.
Prices and currencies. Each ad shows its own price and currency code (USD, CRC, PAB and others). The price filters compare a USD equivalent and the price sort compares the raw amount, so a price in colones can sit next to a price in dollars. pagination.total_results follows a live inventory and can change by one or two between calls. Phone numbers are never returned. Failed requests are not billed.
Run this endpoint
Endpoint
Parameters
Start with the required fields, then add optional filters only when your use case needs them.
Runnable path
This endpoint has no required query parameters.
16 optional filters available.
string
Optional
costa-rica (default), panama, nicaragua or honduras.
US
string
Optional
sale (default) or rent.
example
string
Optional
Slug from the property-types route, such as casas or apartamentos. Not every type exists for both listing types.
example
string
Optional
Region slug from the autocomplete route, for example costa-rica-es-san-jose-provincia.
US
string
Optional
Free text, 2 to 80 characters.
running shoes
number
Optional
Minimum price. Compared as a USD equivalent, whatever the currency of the ad.
10
number
Optional
Maximum price. Compared as a USD equivalent, whatever the currency of the ad.
10
integer
Optional
Minimum bedrooms. Use the same value for min and max for an exact count.
10
integer
Optional
Maximum bedrooms.
10
integer
Optional
Minimum bathrooms.
10
integer
Optional
Maximum bathrooms.
10
integer
Optional
Minimum built area in square meters.
10
integer
Optional
Maximum built area in square meters.
10
integer
Optional
Only ads posted or renewed within 1, 3, 7 or 30 days.
10
string
Optional
relevance (default), price_asc, price_desc or newest. The price sort orders by the raw amount, so currencies can mix.
relevance
integer
Optional
One-based page number, 1 to 2000 (default 1). 20 items per page.
1
Response Schema
Example response fields are illustrative; inspect the JSON before integrating.
Example response fields
Scan these fields before integrating.
data
meta
success
{
"data": {
"items": [
{
"id": "33158611",
"url": "https://www.encuentra24.com/costa-rica-es/bienes-raices-venta-de-propiedades-apartamentos/se-alquila-apartamento-amplio-guachipelin-escazu/33158611",
"rent": null,
"agent": {
"id": "15957518",
"name": "Lucie Steylemans",
"type": "Agente",
"avatar": "https://photos.encuentra24.com/t_user_photo/v1/users/photo/15/95/75/18/15957518_2dc9db",
"company": null,
"license": null,
"verified": false,
"profile_url": "https://www.encuentra24.com/costa-rica-es/user/profile/id/15957518"
},
"badge": null,
"floor": "4",
"media": {
"images": [
"https://photos.encuentra24.com/t_or_fh_m/f_auto/v1/cr/33/15/86/11/33158611_902b7e0",
"https://photos.encuentra24.com/t_or_fh_m/f_auto/v1/cr/33/15/86/11/33158611_bd3ae0e"
],
"video_url": null,
"main_image": "https://photos.encuentra24.com/t_or_fh_m/f_auto/v1/cr/33/15/86/11/33158611_902b7e0",
"youtube_url": null,
"floor_plan_pdf": null
},
"price": {
"amount": 2600,
"symbol": "$",
"currency": "USD"
},
"title": "Se alquila apartamento amplio, Guachipelin, Escazu",
"balcony": null,
"stories": 1,
"bedrooms": 3,
"features": [
"Nevera",
"Microondas",
"Estufa",
"Lavadora",
"Lavaplatos",
"Secadora"
],
"location": {
"region": "Escaz\u00fa",
"address": null,
"latitude": 9.948788,
"locality": "San Jos\u00e9 provincia, Escaz\u00fa",
"longitude": -84.16198,
"exact_address": "San Jos\u00e9, San Rafael, Guachipelin, Costa Rica",
"map_marker_hidden": false
},
"bathrooms": 2.5,
"furnished": true,
"posted_at": "2026-10-24T15:39:59.000Z",
"floor_type": "Cer\u00e1mica",
"updated_at": "2026-10-24T15:39:59.000Z",
"year_built": 2024,
"description": "Hermoso apartamento en Escaz\u00fa.\n\nCerca de todo & con seguridad 24/7.\nPrecio negociable.",
"is_reposted": false,
"lot_area_m2": 198,
"listing_type": "sale",
"pet_friendly": true,
"price_per_m2": {
"built_area": 14.942528735632184,
"total_area": 13.131313131313131
},
"title_status": null,
"built_area_m2": 174,
"featured_tier": "gold",
"property_type": {
"slug": "apartamentos",
"label": "Apartamento"
},
"renewed_until": null,
"swimming_pool": true,
"parking_spaces": 2,
"project_status": null,
"maintenance_fee": null,
"ceiling_height_m": null
},
{
"id": "31916754",
"url": "https://www.encuentra24.com/costa-rica-es/bienes-raices-venta-de-propiedades-casas/casa-en-venta-en-orotina-san-mateo-jesus-maria/31916754",
"rent": null,
"agent": {
"id": "1175655",
"name": "El Due\u00f1o Vende",
"type": "Agente",
"avatar": "https://photos.encuentra24.com/t_user_logo/v1/users/logo/11/75/65/1175655_e826df",
"company": "EL DUE\u00d1O VENDE SA",
"license": null,
"verified": false,
"profile_url": "https://www.encuentra24.com/costa-rica-es/user/profile/id/1175655"
},
"badge": "Ganga",
"floor": null,
"media": {
"images": [
"https://photos.encuentra24.com/t_or_fh_m/f_auto/v1/cr/31/91/67/54/31916754_be0b54c",
"https://photos.encuentra24.com/t_or_fh_m/f_auto/v1/cr/31/91/67/54/31916754_4821ba"
],
"video_url": null,
"main_image": "https://photos.encuentra24.com/t_or_fh_m/f_auto/v1/cr/31/91/67/54/31916754_be0b54c",
"youtube_url": null,
"floor_plan_pdf": null
},
"price": {
"amount": 16500000,
"symbol": "\u20a1",
"currency": "CRC"
},
"title": "Casa en Venta en Orotina San Mateo, Jes\u00fas Maria.",
"balcony": null,
"stories": 1,
"bedrooms": 3,
"features": [],
"location": {
"region": "Orotina",
"address": "Goicoechea Mall El Dorado",
"latitude": 9.912715,
"locality": "Alajuela provincia, Orotina",
"longitude": -84.52735,
"exact_address": "Alajuela, Orotina San Mateo",
"map_marker_hidden": false
},
"bathrooms": 1,
"furnished": null,
"posted_at": "2026-09-26T06:59:59.000Z",
"floor_type": null,
"updated_at": "2026-10-20T13:28:53.000Z",
"year_built": null,
"description": "Hermoso apartamento en Escaz\u00fa.\n\nCerca de todo & con seguridad 24/7.\nPrecio negociable.",
"is_reposted": false,
"lot_area_m2": 213,
"listing_type": "sale",
"pet_friendly": null,
"price_per_m2": {
"built_area": 77464.78873239437,
"total_area": 77464.78873239437
},
"title_status": null,
"built_area_m2": 213,
"featured_tier": "silver",
"property_type": {
"slug": "casas",
"label": "Casa"
},
"renewed_until": null,
"swimming_pool": null,
"parking_spaces": 1,
"project_status": null,
"maintenance_fee": null,
"ceiling_height_m": null
}
],
"notices": [],
"pagination": {
"page": 2,
"per_page": 20,
"total_pages": 248,
"filtered_out": 0,
"has_next_page": true,
"total_results": 4954
},
"applied_filters": {
"sort": "relevance",
"country": "costa-rica",
"listing_type": "sale",
"min_bedrooms": 3
}
},
"meta": {
"billable": true,
"endpoint_family": "search"
},
"success": true
}Errors
Handle these documented responses before retrying or showing customer-facing failures.
Validation Error
A parameter is missing, out of range or not supported. This response is not billable.
{
"errors": {
"country": [
"The selected country is invalid."
]
},
"message": "The request validation failed"
}Upstream Unavailable
Encuentra24 could not be reached or returned data that does not match the request. This response is not billable and is retryable.
{
"meta": {
"billable": false,
"retryable": true,
"endpoint_family": "search"
},
"error": {
"code": "UPSTREAM_UNAVAILABLE",
"message": "Encuentra24 could not be reached. Please retry shortly."
},
"success": false
}Generate Code with AI
Copy a ready-made prompt with all the endpoint details, parameters, and example responses. Paste it into ChatGPT, Claude, or any AI assistant to instantly generate working code.
Try It Live
Test this endpoint in our interactive playground with real data.