# MyHome.ie Agency Profile API Documentation

Scrappa's `GET /api/myhome-ie/agency` returns the public profile of one MyHome.ie estate agency by `id`.

## What you get

`agency` has `id`, `name`, `address`, `phone`, `email`, `website`, `fax`, `logo`, `sales_licence`, `rental_licence`, `latitude`, `longitude`, `description`, `services` (which listing types the agency offers), `parent_agency`, `child_agencies` and `negotiators` (name, job title, photo). The contact data is the business data the agency shows on its public page. Negotiator e-mail addresses are not published.

## Finding the id

Take `agency.id` from any search or listing result, or from the agency directory. An id that is not an agency returns a non-billable `404`.

- **Documentation:** [https://scrappa.co/docs/myhome-ie-api/myhome_ie_agency](https://scrappa.co/docs/myhome-ie-api/myhome_ie_agency)
- **API group:** MyHome.ie API
- **Endpoint:** `GET https://scrappa.co/api/myhome-ie/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 | Yes | Numeric agency id from a listing. |

## Example request

```bash
#!/bin/bash

curl -X GET \
    -H "x-api-key: YOUR_API_KEY_HERE" \
    "https://scrappa.co/api/myhome-ie/agency?id=5543"
```

## Example response

```json
{
    "success": true,
    "agency": {
        "id": 5543,
        "name": "DNG Stillorgan",
        "address": "18 Lower Kilmacud Road, Stillorgan, Co. Dublin",
        "phone": "01 283 2700",
        "email": "stillorgan@dng.ie",
        "logo": "https://photos-a.propertyimages.ie/groups/3/4/5/5543/logo.jpg",
        "sales_licence": "004017",
        "rental_licence": null,
        "url": "https://www.myhome.ie/estate-agents/dng-stillorgan-5543",
        "website": "http://www.dng.ie",
        "latitude": 53.288077,
        "longitude": -6.200323,
        "services": {
            "residential_for_sale": true,
            "new_homes": false,
            "lettings_to_rent": false
        },
        "parent_agency": {
            "id": 269349,
            "name": "DNG Head Office"
        },
        "child_agencies": [],
        "negotiators": [
            {
                "id": 171386,
                "name": "Brian Dempsey",
                "job_title": "Partner",
                "image": "https://photos-a.propertyimages.ie/users/6/8/3/171386/profile.jpg"
            }
        ]
    },
    "meta": {
        "billable": true,
        "endpoint_family": "agency",
        "attempts": 1
    }
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 404 | Not Found | Nothing exists with that id, or the listing is no longer online (`not_found`). Non-billable. |
| 422 | Validation Error | A query parameter failed validation. Non-billable. |
| 503 | Upstream Unavailable | MyHome.ie could not be reached after retries, answered with a body this API cannot read, or did not apply the requested filters (public error code `upstream_unavailable`). Retryable and never billed. Clients are never rate limited. |

## 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)