# CHINTAI Listing Details API Documentation

Scrappa's `GET /api/chintai/listing` returns the full record of one CHINTAI rental room by its `id` (the listing key) from search.

## What you get

`title`, `building_name`, `description`, `management_code`, the rent block (`rent_yen`, `management_fee_yen`, `total_monthly_yen`, `deposit_text` and `deposit_yen`, `guarantee_deposit_text`, `key_money_text` and `key_money_yen`, `amortization_text`, `renewal_fee_text`), `contract_period`, `move_in`, `transaction_type`, `layout`, `layout_detail` with `rooms` (name and tatami mats), `area_m2`, `direction`, `building_type`, `structure`, `built_year`, `age_years`, `floor_number`, `floors_above_ground`, `floors_below_ground`, `address`, `latitude`, `longitude`, `access`, `features` in groups (storage, kitchen and bath, security, communication and more), `details` (conditions, guarantor rules, remarks), all `images`, `building_rooms` (the other rooms the same building lists), `agency` (`id`, `name`, `license`, `phone`, `address`, `business_hours`, `features`), `info_updated_at` and `ad_renewal_due_at`.

## Notes

Japanese text stays as CHINTAI writes it. Numbers are added next to it. A value CHINTAI does not state is `null`, never 0; `なし` (none) is 0. Coordinates come from the detail page and can differ by a few metres from the search result. Some detached houses have no coordinates on the detail page, then `latitude` and `longitude` are `null`. A listing that was taken down returns `404`, which is never billed.

- **Documentation:** [https://scrappa.co/docs/chintai-api/chintai_listing](https://scrappa.co/docs/chintai-api/chintai_listing)
- **API group:** CHINTAI API
- **Endpoint:** `GET https://scrappa.co/api/chintai/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 | Listing key from search, 28 letters and digits, for example C010100011111560075568290001. |

## Example request

```bash
#!/bin/bash

curl -X GET \
    -H "x-api-key: YOUR_API_KEY_HERE" \
    "https://scrappa.co/api/chintai/listing?id=C010100011111560075568290001"
```

## Example response

```json
{
    "success": true,
    "data": {
        "id": "C010100011111560075568290001",
        "url": "https://www.chintai.net/detail/bk-C010100011111560075568290001/",
        "title": "\u30b8\u30aa\u30a4\u30c9\u4e09\u756a\u753a 3\u968e\uff0f\u6771\u4eac\u90fd\u5343\u4ee3\u7530\u533a\u4e09\u756a\u753a\uff08\u5bb6\u8cc335\u4e07\u5186/2LDK\uff09\u306e\u8cc3\u8cb8\u7269\u4ef6\u60c5\u5831",
        "building_name": "\u30b8\u30aa\u30a4\u30c9\u4e09\u756a\u753a",
        "management_code": "C01010001-111156007556829-0001",
        "rent_yen": 350000,
        "management_fee_text": "20,000\u5186",
        "management_fee_yen": 20000,
        "total_monthly_yen": 370000,
        "deposit_text": "1\u30f6\u6708",
        "deposit_yen": 350000,
        "key_money_text": "1\u30f6\u6708",
        "key_money_yen": 350000,
        "renewal_fee_text": "1\u30f6\u6708",
        "contract_period": "\u5b9a\u501f\u5951\u7d04\uff1a2\u5e74\u9593",
        "move_in": "\u5373\u5165\u5c45",
        "transaction_type": "\u4e00\u822c\u5a92\u4ecb",
        "layout": "2LDK",
        "layout_detail": "2LDK(LDK13.7\u30fb\u6d0b\u5ba46.0\u30fb\u6d0b\u5ba45.0)",
        "rooms": [
            {
                "name": "LDK",
                "tatami": 13.7
            },
            {
                "name": "\u6d0b\u5ba4",
                "tatami": 6
            },
            {
                "name": "\u6d0b\u5ba4",
                "tatami": 5
            }
        ],
        "area_m2": 56.45,
        "direction": "\u5357\u6771",
        "building_type": "\u30de\u30f3\u30b7\u30e7\u30f3",
        "structure": "\u9244\u7b4b\u30b3\u30f3\u30af\u30ea\u30fc\u30c8\u9020",
        "built_year": 2019,
        "age_years": 7,
        "floor_number": 3,
        "floors_above_ground": 11,
        "floors_below_ground": 1,
        "address": "\u6771\u4eac\u90fd\u5343\u4ee3\u7530\u533a\u4e09\u756a\u753a",
        "latitude": 35.692285,
        "longitude": 139.744542,
        "access": [
            {
                "text": "\u534a\u8535\u9580\u7dda/\u4e5d\u6bb5\u4e0b\u99c5 \u5f92\u6b699\u5206",
                "line": "\u534a\u8535\u9580\u7dda",
                "station": "\u4e5d\u6bb5\u4e0b\u99c5",
                "walk_minutes": 9
            }
        ],
        "features": {
            "\u30bb\u30ad\u30e5\u30ea\u30c6\u30a3": [
                "\u30aa\u30fc\u30c8\u30ed\u30c3\u30af",
                "\u5b85\u914d\u30dc\u30c3\u30af\u30b9"
            ],
            "\u53ce\u7d0d": [
                "\u30af\u30ed\u30fc\u30bc\u30c3\u30c8",
                "\u30a6\u30a9\u30fc\u30af\u30a4\u30f3\u30af\u30ed\u30fc\u30bc\u30c3\u30c8"
            ]
        },
        "details": {
            "\u4fdd\u967a": "\u640d\u5bb3\u4fdd\u967a\u52a0\u5165\u8981\u3002"
        },
        "images": [
            "https://img.chintai.net/awsorg/bk/ot/C01010001/68/29/111156007556829/021/1111560075568290001_20261026111334076.JPG"
        ],
        "building_rooms": [
            {
                "id": "C010086970000005091882140001",
                "room": "4\u968e0402\u53f7\u5ba4",
                "rent_yen": 355000,
                "management_fee_yen": 20000,
                "deposit_text": "355,000\u5186",
                "deposit_yen": 355000,
                "layout": "2LDK",
                "area_m2": 56.45
            }
        ],
        "agency": {
            "id": "C01010001",
            "name": "\u682a\u5f0f\u4f1a\u793e\u30ea\u30d6\u30fb\u30de\u30c3\u30af\u30b9 \u30ea\u30d6\u30de\u30c3\u30af\u30b9\u79cb\u8449\u539f\u5e97",
            "license": "\u56fd\u571f\u4ea4\u901a\u5927\u81e3\u514d\u8a31\uff085\uff09\u7b2c7032\u53f7",
            "phone": "03-5297-8877",
            "business_hours": "9\uff1a\uff10\uff10\uff5e19\uff1a\uff10\uff10"
        },
        "info_updated_at": "2026-10-26",
        "ad_renewal_due_at": "2026-11-09"
    },
    "meta": {
        "endpoint_family": "listing",
        "billable": true
    }
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 404 | Not Found | No CHINTAI listing has that key. It may have been taken down. (`NOT_FOUND`). Non-billable. |
| 422 | Validation Error | A query parameter is missing, unknown or unusable. Unknown parameters and unknown values are rejected before any lookup, never ignored. Non-billable. |
| 503 | Upstream Unavailable | CHINTAI could not be reached after one retry, answered with an error or changed its format (`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)
