# LIFULL HOME'S Agency API

<p>Get the profile of a real estate agency: name, address with postal code, stations, phone, fax, license number, associations, opening hours, closed days, introduction, specialties, rent and sale listing counts, listing counts by area and staff. The `id` is the `agency.id` of a listing.</p>

- **Documentation:** [https://scrappa.co/docs/lifull-homes-api/lifull_homes_agency](https://scrappa.co/docs/lifull-homes-api/lifull_homes_agency)
- **API group:** LIFULL HOME'S API
- **Endpoint:** `GET https://scrappa.co/api/lifull-homes/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 | Agency id from the `agency.id` field of a listing, e.g. `103558hgFBNbRcrcUI`. |

## Example response

```json
{
    "data": {
        "id": "103558hgFBNbRcrcUI",
        "fax": "03-3378-2712",
        "name": "\u682a\u5f0f\u4f1a\u793e\u30a2\u30b7\u30b9\u30c8 \u521d\u53f0\u5e97",
        "tags": [
            "\u8cc3\u8cb8",
            "\u512a\u826f\u5e97",
            "LINE\u554f\u5408\u305b\u5bfe\u5fdc",
            "\u30af\u30fc\u30dd\u30f3\u6709"
        ],
        "areas": [
            {
                "name": "\u4e16\u7530\u8c37\u533a",
                "listing_count": 62
            },
            {
                "name": "\u6e0b\u8c37\u533a",
                "listing_count": 37
            },
            {
                "name": "\u4e2d\u91ce\u533a",
                "listing_count": 32
            }
        ],
        "phone": "03-3378-2711",
        "staff": [
            {
                "name": "\u6238\u6ce2\u548c",
                "role": "\u526f\u4e3b\u4efb",
                "experience": "\u7d4c\u9a136\u5e74"
            },
            {
                "name": "\u91ce\u5d0e\u6b63\u61b2",
                "role": "\u30b9\u30bf\u30c3\u30d5",
                "experience": "\u7d4c\u9a138\u5e74"
            }
        ],
        "address": "151-0061 \u6771\u4eac\u90fd\u6e0b\u8c37\u533a\u521d\u53f0\uff11\u4e01\u76ee39-11",
        "website": "http://www.chintai-assist.jp/",
        "stations": [
            {
                "raw": "\u4eac\u738b\u7dda \u521d\u53f0\u99c5 \u5f92\u6b691\u5206",
                "line": "\u4eac\u738b\u7dda",
                "station": "\u521d\u53f0",
                "walk_min": 1
            },
            {
                "raw": "\u5c0f\u7530\u6025\u5c0f\u7530\u539f\u7dda \u4ee3\u3005\u6728\u516b\u5e61\u99c5 \u5f92\u6b6915\u5206",
                "line": "\u5c0f\u7530\u6025\u5c0f\u7530\u539f\u7dda",
                "station": "\u4ee3\u3005\u6728\u516b\u5e61",
                "walk_min": 15
            }
        ],
        "prefecture": "\u6771\u4eac\u90fd",
        "source_url": "https://www.homes.co.jp/realtor/mid-103558hgFBNbRcrcUI/",
        "closed_days": "\u6bce\u9031\u6c34\u66dc\u65e5 \u6bce\u6708\u7b2c2\u7b2c4\u706b\u66dc\u65e5",
        "postal_code": "151-0061",
        "specialties": {
            "\u30b5\u30fc\u30d3\u30b9": [
                "\u4fdd\u8a3c\u4eba\u4e0d\u8981\u306a\u7269\u4ef6\u3042\u308a",
                "\u5165\u5c45\u30ed\u30fc\u30f3\u3042\u308a",
                "\u5f15\u8d8a\u3057\u696d\u8005\u7d39\u4ecb\u53ef",
                "\u30af\u30fc\u30dd\u30f3\u3042\u308a"
            ],
            "\u53d6\u6271\u3044\u696d\u52d9": [
                "\u6cd5\u4eba\u5951\u7d04\u53d6\u6271\u3044",
                "\u8cc3\u8cb8\u7ba1\u7406\u696d\u52d9"
            ],
            "\u5e97\u8217\u30b9\u30bf\u30c3\u30d5": [
                "\u5973\u6027\u30b9\u30bf\u30c3\u30d5\u5bfe\u5fdc\u53ef"
            ],
            "\u7acb\u5730\u30fb\u55b6\u696d\u6642\u9593": [
                "19\u6642\u4ee5\u964d\u3082\u55b6\u696d",
                "\u99c5\u304b\u3089\u6b69\u3044\u30663\u5206\u4ee5\u5185",
                "\u5e74\u4e2d\u7121\u4f11"
            ]
        },
        "associations": "(\u516c\u793e)\u9996\u90fd\u570f\u4e0d\u52d5\u7523\u516c\u6b63\u53d6\u5f15\u5354\u8b70\u4f1a\u3001(\u516c\u793e)\u5168\u65e5\u672c\u4e0d\u52d5\u7523\u5354\u4f1a",
        "introduction": "\u2605\u7269\u4ef6\u60c5\u5831\u6570No.1\u2605\u2605\u7b11\u9854\u3067\u304a\u51fa\u8fce\u3048\u3044\u305f\u3057\u307e\u3059\uff01\u2605\u4ed6\u793e\u3055\u3093\u3067\u300c\u3053\u306e\u6761\u4ef6\u3067\u306f\u7121\u3044\u3067\u3059\u3088\u300d\u3068\u8a00\u308f\u308c\u305f\u304a\u90e8\u5c4b\u304c\u3001\u30a2\u30b7\u30b9\u30c8\u521d\u53f0\u2026",
        "business_hours": "10:00\uff5e19:00",
        "license_number": "\u6771\u4eac\u90fd\u77e5\u4e8b(7)\u7b2c071068\u53f7",
        "nearest_station": "\u4eac\u738b\u7dda \u521d\u53f0\u99c5 \u5f92\u6b691\u5206",
        "rent_listing_count": 166
    },
    "meta": {
        "billable": true,
        "endpoint_family": "agency"
    },
    "success": true
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
|  | The listing, agency, area or page does not exist (a page after pagination.last_page also answers 404). This response is not billable. |  |
|  | A parameter or filter is missing, invalid or not available for the property type. This response is not billable. |  |
|  | LIFULL HOME'S is temporarily unavailable or answered a page that no longer matches the documented contract. Retry the request. This response is not billable. |  |

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