# Encuentra24 Agent API Documentation

<p><strong>Encuentra24 Agent API</strong> returns the profile of an agent or agency and one page of their ads (8 per page). Pass the <code>id</code> from <code>agent.id</code> of a search item. The profile has the name, member since, rating, license number, website, city, region, about text, photo, logo, ads count and map position. The ads have the same fields as search items.</p><p>A page past the last one returns an empty list with the real page counts. An unknown agent returns a 404 error. Phone numbers are never returned. Failed requests are not billed.</p>

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

## 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 |
| --- | --- | --- | --- |
| `id` | integer | Yes | Agent id from a search item (agent.id). |
| `country` | string | No | costa-rica (default), panama, nicaragua or honduras. |
| `page` | integer | No | One-based page of the ads, 1 to 2000 (default 1). 8 ads per page. |

## Example response

```json
{
    "data": {
        "agent": {
            "id": "15957518",
            "url": "https://www.encuentra24.com/costa-rica-es/user/profile/id/15957518",
            "city": "Santa Ana Centro",
            "logo": null,
            "name": "Lucie Steylemans",
            "team": [],
            "about": "Mucho gusto me llamo Lucie Steylemans :)\n\nSoy asesora inmobiliaria afiliada a la C\u00e1mara Costarricense de Corredores de Bienes Ra\u00edces, con dos a\u00f1os de experien",
            "photo": "https://photos.encuentra24.com/t_user_photo/v1/users/photo/15/95/75/18/15957518_2dc9db",
            "seals": [],
            "rating": 84,
            "region": "Santa Ana Centro",
            "website": null,
            "latitude": 9.913940628547998,
            "verified": false,
            "ads_count": 44,
            "longitude": -84.03811454772949,
            "is_business": true,
            "member_plan": "U_P1_CR",
            "member_since": "2025-02-04",
            "social_links": [],
            "opening_hours": null,
            "license_number": null,
            "business_images": [],
            "facebook_verified": false
        },
        "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
            }
        ],
        "pagination": {
            "page": 1,
            "per_page": 8,
            "total_pages": 6,
            "has_next_page": true,
            "total_results": 44
        }
    },
    "meta": {
        "billable": true,
        "endpoint_family": "agent"
    },
    "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 agent does not exist. 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)