# Encuentra24 Search API Documentation

<p><strong>Encuentra24 Search API</strong> returns properties for sale or for rent in Costa Rica, Panama, Nicaragua and Honduras as JSON, 20 per page. Pick a <code>country</code> and a <code>listing_type</code>, 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 <code>url</code> works in the listing route and <code>agent.id</code> in the agent route.</p><p><strong>Filters are never ignored.</strong> Items that break a requested filter are not returned and are counted in <code>pagination.filtered_out</code>. 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.</p><p><strong>Prices and currencies.</strong> 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. <code>pagination.total_results</code> follows a live inventory and can change by one or two between calls. Phone numbers are never returned. Failed requests are not billed.</p>

- **Documentation:** [https://scrappa.co/docs/encuentra24-api/encuentra24_search](https://scrappa.co/docs/encuentra24-api/encuentra24_search)
- **API group:** Encuentra24 API
- **Endpoint:** `GET https://scrappa.co/api/encuentra24/search`

## Authentication

Send your Scrappa API key in the `X-API-KEY` request header. Paid endpoints also support accountless x402 payments when called without an API key.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `country` | string | No | costa-rica (default), panama, nicaragua or honduras. |
| `listing_type` | string | No | sale (default) or rent. |
| `property_type` | string | No | Slug from the property-types route, such as casas or apartamentos. Not every type exists for both listing types. |
| `region` | string | No | Region slug from the autocomplete route, for example costa-rica-es-san-jose-provincia. |
| `keyword` | string | No | Free text, 2 to 80 characters. |
| `min_price` | number | No | Minimum price. Compared as a USD equivalent, whatever the currency of the ad. |
| `max_price` | number | No | Maximum price. Compared as a USD equivalent, whatever the currency of the ad. |
| `min_bedrooms` | integer | No | Minimum bedrooms. Use the same value for min and max for an exact count. |
| `max_bedrooms` | integer | No | Maximum bedrooms. |
| `min_bathrooms` | integer | No | Minimum bathrooms. |
| `max_bathrooms` | integer | No | Maximum bathrooms. |
| `min_area` | integer | No | Minimum built area in square meters. |
| `max_area` | integer | No | Maximum built area in square meters. |
| `posted_within_days` | integer | No | Only ads posted or renewed within 1, 3, 7 or 30 days. |
| `sort` | string | No | relevance (default), price_asc, price_desc or newest. The price sort orders by the raw amount, so currencies can mix. |
| `page` | integer | No | One-based page number, 1 to 2000 (default 1). 20 items per page. |

## Example response

```json
{
    "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

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | A parameter is missing, out of range or not supported. This response is not billable. |
| 503 | Upstream Unavailable | Encuentra24 could not be reached or returned data that does not match the request. This response is not billable and is retryable. |

## More Scrappa resources

- [API documentation](https://scrappa.co/docs)
- [Full LLM-readable API reference](https://scrappa.co/llms-full.txt)
- [OpenAPI specification](https://scrappa.co/docs/api.json)
- [Pricing](https://scrappa.co/pricing)