# LIFULL HOME'S Sale Listing API

<p>Get one sale listing (mansion, house, land or new-build project) with price (or price range), management fee, repair reserve, address with postal code, coordinates (`lat`, `lng`), floor area, layout, year built, all stations with walk minutes, features, up to 30 photos with captions, every printed specification in `specs` and the sales company (`agency.id` works in the agency endpoint). An unknown or sold listing answers 404 and is not billed.</p>

- **Documentation:** [https://scrappa.co/docs/lifull-homes-api/lifull_homes_sale_listing](https://scrappa.co/docs/lifull-homes-api/lifull_homes_sale_listing)
- **API group:** LIFULL HOME'S API
- **Endpoint:** `GET https://scrappa.co/api/lifull-homes/sale/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 |
| --- | --- | --- | --- |
| `id` | string | Yes | Sale listing id from the `id` field of a sale search result. |
| `vertical` | string | Yes | `mansion`, `kodate` (house) or `tochi` (land), as in the `vertical` field of the search result. |

## Example response

```json
{
    "data": {
        "id": "1090830005111",
        "lat": 35.68557674517,
        "lng": 139.71780433467,
        "fees": {
            "management_fee_yen": 12650,
            "repair_reserve_yen": 18810
        },
        "name": "\u30d1\u30fc\u30af\u30fb\u30b3\u30fc\u30c8\u56db\u8c37 3\u968e/302",
        "floor": "3\u968e",
        "rooms": 2,
        "specs": {
            "\u6240\u5728\u5730": "\u6771\u4eac\u90fd\u65b0\u5bbf\u533a\u5927\u4eac\u753a7-1",
            "\u7bc9\u5e74\u6708": "2002\u5e7412\u6708\uff08\u7bc924\u5e74\uff09",
            "\u9593\u53d6\u308a": "1SLDK",
            "\u5c02\u6709\u9762\u7a4d": "52.26\u33a1\uff08\u58c1\u5fc3\uff09",
            "\u7269\u4ef6\u7a2e\u5225": "\u4e2d\u53e4\u30de\u30f3\u30b7\u30e7\u30f3",
            "\u9593\u53d6\u308a\u8a73\u7d30": "\u30ea\u30d3\u30f3\u30b0\u30c0\u30a4\u30cb\u30f3\u30b0\u30ad\u30c3\u30c1\u30f3 13.1\u5e16\n\u6d0b\u5ba4 4.7\u5e16\n\u53ce\u7d0d 4.4\u5e16",
            "\u30d0\u30eb\u30b3\u30cb\u30fc\u9762\u7a4d": "7\u33a1",
            "\u99d0\u8eca\u5834\u6599\u91d1(\u7a0e\u7121)": "\u7a7a\u6709 45,000\u5186(\u7a0e\u8fbc) \u7269\u4ef6\u304b\u3089\u306e\u8ddd\u96e20m \u6599\u91d1\u6700\u5c0f:38000\u5186 \u6599\u91d1\u6700\u5927:45000\u5186"
        },
        "terms": {
            "\u5099\u8003": "\u65bd\u5de5\u4f1a\u793e\uff1a\u4e09\u4e95\u5efa\u8a2d(\u682a)\n\u300e \u30e6\u30ca\u30a4\u30c6\u30c3\u30c9\u30a2\u30ed\u30fc\u30ba\u793e\u76e3\u4fee\u30ea\u30ce\u30d9\u30fc\u30b7\u30e7\u30f3\u7269\u4ef6 \u300f\n\u2015\u66ae\u3089\u3057\u306e\u666e\u904d\u3092\u4e01\u5be7\u306b\u898b\u3064\u3081\u306a\u304c\u3089\u3001\n\u3000",
            "\u53d6\u5f15\u614b\u69d8": "\u58f2\u4e3b",
            "\u7ba1\u7406\u8cbb\u7b49": 12650,
            "\u30da\u30c3\u30c8\u76f8\u8ac7": "\u76f8\u8ac7\u53ef",
            "\u4fee\u7e55\u7a4d\u7acb\u91d1": 18810,
            "\u5f15\u6e21\u3057\u6642\u671f": "\u5373\u6642",
            "\u99d0\u8eca\u5834\u6599\u91d1(\u7a0e\u7121)": "\u7a7a\u6709 45,000\u5186(\u7a0e\u8fbc) \u7269\u4ef6\u304b\u3089\u306e\u8ddd\u96e20m \u6599\u91d1\u6700\u5c0f:38000\u5186 \u6599\u91d1\u6700\u5927:45000\u5186"
        },
        "title": "\u3010\u30db\u30fc\u30e0\u30ba\u3011\u30d1\u30fc\u30af\u30fb\u30b3\u30fc\u30c8\u56db\u8c37 302 12,990\u4e07\u5186\u30fb1SLDK\uff5c\u65b0\u5bbf\u533a\u306e\u4e2d\u53e4\u30de\u30f3\u30b7\u30e7\u30f3",
        "agency": {
            "id": "109083hNUl2kTJ4S74",
            "url": "https://www.homes.co.jp/realtor/mid-109083hNUl2kTJ4S74/",
            "name": "\u30b0\u30ed\u30fc\u30d0\u30eb\u30d9\u30a4\u30b9\u682a\u5f0f\u4f1a\u793e"
        },
        "images": [
            {
                "url": "https://image.homes.jp/smallimg/image.php?file=http%3A%2F%2Fimg.homes.jp%2F109083%2Fsale%2F5111%2F11%2F1%2Fe5by.jpg",
                "caption": "\u81ea\u7136\u611f\u3092\u6d3b\u304b\u3057\u305f\u512a\u3057\u3044\u8272\u5408\u3044\u3068\u3086\u3063\u305f\u308a\u3068\u3057\u305f\u6291\u63da\u306e\u3042\u308b\u5efa\u5177\u3092\u63a1\u7528\u3057\u307e\u3057\u305f\u3002\u6d41\u884c\u3068\u5b89\u3089\u304e\u306e\u8c4a\u304b\u306a\u5171\u5b58\u306e\u98a8\u5408\u3044\u306f\u3001\u7a7a\u9593\u306b\u6eb6\u3051\u8fbc\u307f\u3001\u5e45\u5e83\u3044\u5bb6\u5177\u3084\u30a4\u30f3\u30c6\u30ea\u30a2\u3068\u8abf\u548c\u3057\u307e\u3059\u3002"
            },
            {
                "url": "https://image3.homes.jp/smallimg/image.php?file=http%3A%2F%2Fimg.homes.jp%2F109083%2Fsale%2F5111%2F5%2F5%2Fhe13.jpg",
                "caption": "\u5149\u3068\u5f71\u304c\u7e54\u308a\u306a\u3059\u30ea\u30d6\u30d1\u30cd\u30eb\u306e\u610f\u5320\u304c\u3001\u4f4f\u307e\u3044\u306b\u51db\u3068\u3057\u305f\u6c17\u54c1\u3068\u6df1\u307f\u3092\u6dfb\u3048\u308b\u7a7a\u9593\u3067\u3059\u3002\u65e5\u5e38\u3092\u7279\u5225\u306a\u30b7\u30fc\u30f3\u3078\u3068\u6607\u83ef\u3057\u3001\u4f4f\u307e\u3046\u65b9\u306e\u611f\u6027\u3092\u8c4a\u304b\u306b\u6e80\u305f\u3057\u307e\u3059\u3002"
            }
        ],
        "layout": "1SLDK",
        "address": {
            "city": "\u65b0\u5bbf\u533a",
            "full": "\u6771\u4eac\u90fd\u65b0\u5bbf\u533a\u5927\u4eac\u753a7-1",
            "street": "\u5927\u4eac\u753a7-1",
            "prefecture": "\u6771\u4eac\u90fd",
            "postal_code": "160-0015"
        },
        "features": [
            "\u30ac\u30b9\u30b3\u30f3\u30ed\u8a2d\u7f6e\u6e08",
            "\u30b3\u30f3\u30ed\u4e09\u53e3",
            "\u30b7\u30b9\u30c6\u30e0\u30ad\u30c3\u30c1\u30f3",
            "\u30ab\u30a6\u30f3\u30bf\u30fc\u30ad\u30c3\u30c1\u30f3",
            "\u6d44\u6c34\u5668\u30fb\u6d3b\u6c34\u5668",
            "\u30aa\u30fc\u30d7\u30f3\u30ad\u30c3\u30c1\u30f3",
            "\u5c02\u7528\u30d0\u30b9",
            "\u5c02\u7528\u30c8\u30a4\u30ec"
        ],
        "stations": [
            {
                "raw": "\u6771\u4eac\u30e1\u30c8\u30ed\u4e38\u30ce\u5185\u7dda \u56db\u8c37\u4e09\u4e01\u76ee\u99c5 \u5f92\u6b695\u5206",
                "line": "\u6771\u4eac\u30e1\u30c8\u30ed\u4e38\u30ce\u5185\u7dda",
                "station": "\u56db\u8c37\u4e09\u4e01\u76ee",
                "walk_min": 5
            },
            {
                "raw": "JR\u7dcf\u6b66\u7dda \u4fe1\u6fc3\u753a\u99c5 \u5f92\u6b6910\u5206",
                "line": "JR\u7dcf\u6b66\u7dda",
                "station": "\u4fe1\u6fc3\u753a",
                "walk_min": 10
            }
        ],
        "posted_at": "2026-08-03",
        "price_yen": 129900000,
        "source_url": "https://www.homes.co.jp/mansion/b-1090830005111/",
        "updated_at": "2026-10-25",
        "year_built": 2002,
        "description": "\u30d1\u30fc\u30af\u30fb\u30b3\u30fc\u30c8\u56db\u8c37 302\u306e\u7269\u4ef6\u8a73\u7d30\u3002\u65b0\u5bbf\u533a\u3001\u6771\u4eac\u30e1\u30c8\u30ed\u4e38\u30ce\u5185\u7dda \u56db\u8c37\u4e09\u4e01\u76ee\u99c5 \u5f92\u6b695\u5206\u30011SLDK\u306e\u7269\u4ef6\u3002\u30ea\u30d5\u30a9\u30fc\u30e0\u30fb\u30ea\u30ce\u30d9\u30fc\u30b7\u30e7\u30f3\u6e08\u3001\u5c0f\u5b66\u6821 800\uff4d\u4ee5\u5185\u3001\u516c\u5712 400\uff4d\u4ee5\u5185\u306e\u4e2d\u53e4\u30de\u30f3\u30b7\u30e7\u30f3\u3067\u3059\u3002\u3010LIFULL HO\u2026",
        "identifiers": {
            "\u7269\u4ef6\u756a\u53f7": "1090830005111",
            "\u81ea\u793e\u7ba1\u7406\u756a\u53f7": "B00277-002150",
            "LIFULL HOME'S \u7269\u4ef6\u756a\u53f7": "0109083-0005111"
        },
        "availability": "InStock",
        "listing_type": "sale",
        "floor_area_m2": 52.26,
        "property_kind": "Condominium",
        "valid_through": "2026-11-01",
        "price_currency": "JPY",
        "property_label": "\u4e2d\u53e4\u30de\u30f3\u30b7\u30e7\u30f3"
    },
    "meta": {
        "billable": true,
        "endpoint_family": "sale_listing"
    },
    "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)
