# Lamudi Agency API Documentation

<p><strong>Lamudi Agency API</strong> returns an agency profile with name, address, description, join year, logo, verified and premium flags, the property count and a page of its listings. A page past the last page returns an empty page with <code>has_next</code> false. Phone numbers are not returned.</p>

- **Documentation:** [https://scrappa.co/docs/lamudi-api/lamudi_agency](https://scrappa.co/docs/lamudi-api/lamudi_agency)
- **API group:** Lamudi API
- **Endpoint:** `GET https://scrappa.co/api/lamudi/agency`

## 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` | string | No | Agency id from the listing route. |
| `url` | string | No | Full lamudi.com.ph agency URL, instead of id. |
| `page` | integer | No | One-based page number. Default 1. |

## Example response

```json
{
    "data": {
        "items": [
            {
                "id": "41032-73-b74348b65ed-b489-1a0ffcd-8392-7306",
                "geo": {
                    "exact": false,
                    "latitude": 14.264632,
                    "longitude": 121.0741304
                },
                "url": "https://www.lamudi.com.ph/property/41032-73-b74348b65ed-b489-1a0ffcd-8392-7306",
                "tags": [
                    "Featured",
                    "Fully verified"
                ],
                "price": {
                    "text": "\u20b1 10,000,000",
                    "amount": 10000000,
                    "period": null,
                    "currency": "PHP"
                },
                "title": "House For Sale in Don Jose",
                "agency": {
                    "url": null,
                    "logo": "https://images.proppit.com/publisher/59935325-6b80-4393-94b4-e44d489fefb4/logo.jpeg",
                    "name": "Realty 8 Property Management",
                    "premium": true,
                    "joined_year": 2026
                },
                "address": {
                    "region": null,
                    "street": null,
                    "locality": null,
                    "location_text": "Don Jose, Santa Rosa, Laguna"
                },
                "project": null,
                "bedrooms": 4,
                "bathrooms": 2,
                "thumbnail": "https://img.lamudi.com/fixture-4",
                "floor_area": 170,
                "description": null,
                "photo_count": 4,
                "principal_amenity": "Garage"
            }
        ],
        "agency": {
            "id": "x",
            "url": "https://www.lamudi.com.ph/real-estate-agent/x",
            "logo": "https://images.proppit.com/publisher/59935325-6b80-4393-94b4-e44d489fefb4/logo.jpeg",
            "name": "Realty 8 Property Management",
            "address": "RS Commercial Building, Galicia III, Mendez, Cavite, Pilipinas",
            "premium": true,
            "verified": true,
            "description": "Realty 8 is a trusted real estate brokerage company specializing in the sale, purchase, leasing, and marketing of residential and investment properties. We prov...",
            "joined_year": 2026,
            "property_count": 35
        },
        "pagination": {
            "page": 1,
            "total": 35,
            "has_next": true,
            "total_pages": 2
        }
    },
    "meta": {
        "billable": true,
        "endpoint_family": "agency"
    },
    "success": true
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | A required parameter or a value is invalid. This response is not billable. |
| 404 | Not Found | The agency does not exist. This response is not billable. |
| 503 | Upstream Unavailable | Lamudi 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)