# Encuentra24 Listing API Documentation

<p><strong>Encuentra24 Listing API</strong> returns the full record of one listing as JSON. Pass the <code>link</code> of a search item (the <code>url</code> field, as a path or the full URL) or the listing <code>id</code> with a <code>country</code>. The record has the same fields as a search item (price with currency, fees, area, rooms, address, coordinates, features, all photos, video, floor plan and the agent) plus <code>structured_data</code> with the availability and address parts of the page.</p><p>An unknown or removed listing returns a 404 error. Phone numbers are never returned. Failed requests are not billed.</p>

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

## 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 |
| --- | --- | --- | --- |
| `link` | string | No | The url of a search item, as a path or the full encuentra24.com URL. Use this or id. |
| `id` | string | No | Listing id from a search item. Use this or link. |
| `country` | string | No | With id: costa-rica (default), panama, nicaragua or honduras. |

## Example response

```json
{
    "data": {
        "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": [
            "Gimnasio",
            "Seguridad 24 Horas",
            "Lavander\u00eda",
            "Sal\u00f3n de fiestas",
            "\u00c1rea Social",
            "Parque Infantil",
            "\u00c1rea de BBQ",
            "Sala de reuniones",
            "1 o m\u00e1s elevadores",
            "Planta El\u00e9ctrica",
            "Acceso para discapacitados",
            "Escaleras de emergencia",
            "Cerca de Escuela",
            "Cerca del Tr\u00e1fico",
            "Vista a las Monta\u00f1as",
            "F\u00e1cil acceso",
            "Despensa",
            "Walk-in closet",
            "Ba\u00f1o visitas",
            "Cocina amoblada",
            "Nevera",
            "Microondas",
            "Estufa",
            "Lavadora",
            "Lavaplatos",
            "Secadora"
        ],
        "location": {
            "region": "Escaz\u00fa",
            "address": null,
            "latitude": 9.9487877,
            "locality": "San Jos\u00e9 provincia, Escaz\u00fa",
            "longitude": -84.1619788,
            "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,
        "structured_data": {
            "price": 2600,
            "seller": {
                "name": "Lucie Steylemans",
                "region": "Escaz\u00fa",
                "locality": "Santa Ana Centro"
            },
            "address": {
                "street": "San Jos\u00e9, San Rafael, Guachipelin, Costa Rica",
                "country": "Costa Rica",
                "locality": "Escaz\u00fa",
                "postal_code": null
            },
            "currency": "USD",
            "availability": "InStock"
        },
        "ceiling_height_m": null
    },
    "meta": {
        "billable": true,
        "endpoint_family": "listing"
    },
    "success": true
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | A parameter is missing, out of range or not supported. This response is not billable. |
| 404 | Not Found | The listing does not exist or was removed. 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)