Real estate prices published by MLIT, by municipality
realestate_prices_by_municipalityRead-onlyIdempotent
What real estate transaction and contract prices has MLIT (Japan) published for this municipality and quarter? Give a 5-digit municipality code and up to 8 quarters (YYYY-Qn). Per quarter and per classification (never pooled): records_published, no_records_published or unknown with a reason, record counts, min/median/max computed by us (null below 5 values), and a capped sample of records as published. Carries the required MLIT credit. Statistics as published; not an appraisal or advice.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| to | No | Last quarter, e.g. 2025-Q4 (default: same as from). At most 8 quarters per request. | |
| from | Yes | First quarter, e.g. 2025-Q1 (Q1 = Jan-Mar). Transaction prices start at 2005-Q3, contract prices at 2021-Q1. | |
| sample_size | No | Number of published records to include as a sample, 0-50 (default 10). total and truncated tell how many matched. | |
| property_type | No | Optional filter on MLIT's transaction type: land (宅地(土地)), land_and_building (宅地(土地と建物)), used_condominium (中古マンション等), agricultural_land (農地), forest_land (林地). | |
| municipality_code | Yes | 5-digit Japanese municipality code, e.g. 13101 (Chiyoda, Tokyo). Find codes with realestate_municipalities. Unknown codes are rejected, not guessed. | |
| price_classification | No | transaction (MLIT 不動産取引価格情報), contract (MLIT 成約価格情報) or both (default). |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| query | Yes | ||
| terms | Yes | URL of the terms of service. | |
| sample | Yes | ||
| status | Yes | records_published = at least one quarter has published records matching the query; no_records_published = every quarter was answered and none has matching records; unknown = nothing found and at least one quarter could not be determined (see quarters[].unknown_reason). An upstream failure is never reported as no records. | |
| complete | Yes | true when no quarter is unknown. | |
| quarters | Yes | ||
| provenance | Yes | Freshness receipts for every upstream source used. | |
| answered_at | Yes | ||
| attribution | Yes | Required credit (MLIT API terms, Article 7; credit_ja is the required wording) and the statement that counts and statistics are computed by MK Career Planning. Keep it when you pass results on. | |
| legal_notice | Yes | ||
| municipality | Yes | As published in MLIT's municipality list (XIT002). Null when the list could not be read. | |
| retrieved_at | Yes | Earliest time the data used here was retrieved from MLIT (cached answers keep their original retrieval time). | |
| computed_note | Yes | ||
| quarters_covered | Yes | Quarters actually answered (records_published or no_records_published). | |
| small_sample_min | Yes | Statistics with fewer values than this return only n (min, median and max are null). | |
| quarters_requested | Yes | ||
| classification_note | Yes | Transaction and contract prices are summarised separately; the same deal may appear in both datasets. | |
| max_quarters_per_request | Yes |