# SUUMO Sale Listing API

<p>Retrieve one property for sale: price, layout, area (land and building area for houses), floor, structure, build month, address, every station with walk minutes, management fee, repair reserve, handover, direction, land rights, zoning, parking, all photos with captions and the sales company with licence number and address. Send the four values the sale search returns for the property: id, property_type, prefecture and city. Other labelled values of the page are returned in `attributes`. Telephone numbers are removed.</p>

- **Documentation:** [https://scrappa.co/docs/suumo-api/suumo_sale_listing](https://scrappa.co/docs/suumo-api/suumo_sale_listing)
- **API group:** SUUMO API
- **Endpoint:** `GET https://scrappa.co/api/suumo/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, e.g. `21987904`. |
| `property_type` | string | Yes | `used_mansion`, `new_mansion`, `new_house` or `used_house`, as in the property_type field of the search result. |
| `prefecture` | string | Yes | The `prefecture` value of the search result, e.g. `tokyo`. |
| `city` | string | Yes | The `city` value of the search result, e.g. `sc_shinjuku`. |

## Example response

```json
{
    "data": {
        "id": "21987904",
        "city": "sc_shinjuku",
        "name": "\u57ce\u5317\u53f0\u30de\u30f3\u30b7\u30e7\u30f3",
        "tags": [
            "\u65b0\u7740"
        ],
        "floor": "4\u968e",
        "images": [
            {
                "url": "https://img01.suumo.com/jj/resizeImage?src=gazo%2Fbukken%2F030%2FN010000%2Fimg%2F904%2F21987904%2F21987904_0031.jpg&w=500",
                "caption": "\u30ea\u30d3\u30f3\u30b0"
            }
        ],
        "layout": "1LDK",
        "zoning": "\uff11\u7a2e\u4e2d\u9ad8",
        "address": "\u6771\u4eac\u90fd\u65b0\u5bbf\u533a\u5f01\u5929\u753a76-5",
        "area_m2": 37.18,
        "company": {
            "name": "\u6771\u4eac\u30de\u30f3\u30b7\u30e7\u30f3(\u682a)\u65b0\u5bbf\u4f4f\u53cb\u30d3\u30eb\u672c\u793e",
            "address": "\u3012160-0023 \u6771\u4eac\u90fd\u65b0\u5bbf\u533a\u897f\u65b0\u5bbf2-6-1 \u65b0\u5bbf\u4f4f\u53cb\u30d3\u30eb19\u968e",
            "license": "\u56fd\u571f\u4ea4\u901a\u5927\u81e3\uff083\uff09\u7b2c008684\u53f7",
            "transaction_type": "\u4ef2\u4ecb"
        },
        "handover": "\u5373\u5f15\u6e21\u53ef",
        "headline": "\u300e\u725b\u8fbc\u67f3\u753a\u300f\u99c5 5\u5206 \u516c\u5712\u5411\u304d\u306e\u304a\u90e8\u5c4b \u30aa\u30fc\u30c8\u30ed\u30c3\u30af\uff06\u5b85\u914d\u30dc\u30c3\u30af\u30b9\u3042\u308a",
        "stations": [
            {
                "raw": "\u90fd\u55b6\u5927\u6c5f\u6238\u7dda\u300c\u725b\u8fbc\u67f3\u753a\u300d\u6b695\u5206",
                "line": "\u90fd\u55b6\u5927\u6c5f\u6238\u7dda",
                "station": "\u725b\u8fbc\u67f3\u753a",
                "walk_min": 5
            },
            {
                "raw": "\u6771\u4eac\u30e1\u30c8\u30ed\u6771\u897f\u7dda\u300c\u795e\u697d\u5742\u300d\u6b6911\u5206",
                "line": "\u6771\u4eac\u30e1\u30c8\u30ed\u6771\u897f\u7dda",
                "station": "\u795e\u697d\u5742",
                "walk_min": 11
            }
        ],
        "age_years": 56,
        "area_text": "37.18m2\uff0811.24\u576a\uff09",
        "direction": "\u897f",
        "price_yen": 30990000,
        "structure": "RC6\u968e\u5efa",
        "built_text": "1970\u5e744\u6708",
        "prefecture": "tokyo",
        "price_text": "3099\u4e07\u5186",
        "source_url": "https://suumo.jp/ms/chuko/tokyo/sc_shinjuku/nc_21987904/",
        "updated_on": "2026-10-25",
        "built_month": "1970-04",
        "land_rights": "\u5730\u4e0a\u6a29\uff08\u65e7\uff09\u3001\u501f\u5730\u671f\u9593\u6b8b\u5b583\u5e7411\u30f6\u6708",
        "total_units": 37,
        "property_type": "used_mansion",
        "units_for_sale": 1,
        "management_fee_yen": 12641,
        "repair_reserve_yen": 14742,
        "management_fee_text": "1\u4e072641\u5186\uff0f\u6708\uff08\u59d4\u8a17(\u5de1\u56de)\uff09",
        "repair_reserve_text": "1\u4e074742\u5186\uff0f\u6708"
    },
    "meta": {
        "billable": true,
        "endpoint_family": "sale_listing"
    },
    "success": true
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
|  | The listing does not exist or is no longer online. This response is not billable. |  |
|  | A parameter or filter is missing, invalid or not available for the property type. This response is not billable. |  |
|  | SUUMO 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)