/mlit_reinfolib/transactions/search

POST /api/mlit_reinfolib/transactions/search

Price: 5 credits

Japanese real-estate transaction and contract prices from the MLIT Real Estate Information Library (不動産情報ライブラリ) by prefecture, municipality, district or station: quarter, property kind, price, price per m² and per tsubo, area, land shape and frontage, building structure, use, floor plan and build year, front road, zoning, coverage and floor area ratios

How to use it

Pass one area: prefecture_code, city_code, district_code (from mlit_reinfolib/areas/search) or station_code (from mlit_reinfolib/stations/search). Dates match by quarter.

Parameters

• access-token string required

Request body

• timeout integer — Max scrapping execution timeout (in seconds) (default: 300; min: 20; max: 1500)
• count integer required — Max number of results (min: 1; max: 8000)
• prefecture_code string nullable — Two-digit prefecture code (examples: "13")
• city_code string nullable — Five-digit municipality code (examples: "13101")
• district_code string nullable — Nine-digit district code (examples: "131010540")
• station_code string nullable — Five-digit station code (examples: "02334")
• price_categories array nullable — Transaction prices, contract prices, or both (one of: "transaction", "contract"; examples: ["contract"])
• property_kind string — Kind of property traded (default: "all"; one of: "all", "residential", "land", "land_and_building", "pre_owned_condo", "farmland", "forest"; examples: "pre_owned_condo")
• date_from integer nullable — Earliest transaction date, unix seconds (examples: 1735689600; min: 0)
• date_to integer nullable — Latest transaction date, unix seconds (examples: 1767225599; min: 0)
• price_min integer nullable — Lowest total price, yen (examples: 30000000; min: 0)
• price_max integer nullable — Highest total price, yen (examples: 80000000; min: 0)
• unit_price_min integer nullable — Lowest price per m², yen (examples: 500000; min: 0)
• unit_price_max integer nullable — Highest price per m², yen (examples: 2000000; min: 0)
• area_min integer nullable — Smallest area, m² (examples: 50; min: 0)
• area_max integer nullable — Largest area, m² (examples: 100; min: 0)
• built_year_min integer nullable — Earliest build year (examples: 2000; min: 1800)
• built_year_max integer nullable — Latest build year (examples: 2015; min: 1800)
• station_minutes_max integer nullable — Longest walk to the nearest station, minutes (examples: 10; min: 0)
• structures array nullable — Building structures (one of: "src", "rc", "steel", "wood", "block", "light_steel"; examples: ["rc","src"])
• building_uses array nullable — Building uses (one of: "house", "apartment", "factory", "office", "workshop", "warehouse", "parking", "shop", "other"; examples: ["house"])
• zonings array nullable — Zoning districts (one of: "neighborhood_commercial", "commercial", "exclusive_industrial", "industrial", "quasi_industrial", "category_1_low_rise_residential", "category_2_low_rise_residential", "category_1_mid_high_rise_residential", "category_2_mid_high_rise_residential", "category_1_residential", "category_2_residential", "quasi_residential", "rural_residential", "non_delineated", "urbanization_control", "quasi_city_planning", "outside_city_planning"; examples: ["commercial"])
• renovation string nullable — Renovation state of pre-owned condos (one of: "renovated", "not_renovated"; examples: "renovated")
• sort_by string nullable — Sort column (one of: "price", "unit_price", "area", "total_floor_area", "built_year", "station_minutes"; examples: "price")
• sort_order string — Sort direction (default: "asc"; one of: "asc", "desc"; examples: "desc")

Response

• @type string (default: "MlitTransaction")
• id string required
• price_category string nullable (one of: "transaction", "contract")
• land_control_number string nullable
• serial_number string nullable
• rmi_number string nullable
• quarter string nullable
• property_type_code string nullable
• property_type string nullable
• property_type_ja string nullable
• prefecture_code string nullable
• prefecture string nullable
• prefecture_ja string nullable
• city_code string nullable
• city string nullable
• city_ja string nullable
• district_code string nullable
• district string nullable
• district_ja string nullable
• station_code string nullable
• station string nullable
• station_ja string nullable
• station_minutes integer nullable
• station_distance string nullable
• land_use_category_code string nullable
• land_use_category string nullable
• land_use_category_ja string nullable
• transaction_type_code string nullable
• transaction_type string nullable
• transaction_type_ja string nullable
• price number nullable
• unit_price_per_sqm number nullable
• unit_price_per_tsubo number nullable
• area number nullable
• area_text string nullable
• land_shape_code string nullable
• land_shape string nullable
• land_shape_ja string nullable
• frontage number nullable
• frontage_text string nullable
• total_floor_area number nullable
• total_floor_area_text string nullable
• built_year integer nullable
• built_year_text string nullable
• building_structure_code string nullable
• building_structure string nullable
• building_structure_ja string nullable
• building_use_code string nullable
• building_use string nullable
• building_use_ja string nullable
• floor_plan_code string nullable
• floor_plan string nullable
• floor_plan_ja string nullable
• future_use_code string nullable
• future_use string nullable
• future_use_ja string nullable
• front_road_direction_code string nullable
• front_road_direction string nullable
• front_road_direction_ja string nullable
• front_road_type_code string nullable
• front_road_type string nullable
• front_road_type_ja string nullable
• front_road_width number nullable
• zoning_code string nullable
• zoning string nullable
• zoning_ja string nullable
• building_coverage_ratio number nullable
• floor_area_ratio number nullable
• renovation_code string nullable
• renovation string nullable
• renovation_ja string nullable
• remark_code string nullable
• remark string nullable
• remark_ja string nullable

Errors

• 422 — The request body did not validate Check the fields against this schema. A URN with the wrong prefix is the most common cause.
• 408 — The request ran past its time limit Raise `timeout` in the request body, up to the maximum this endpoint documents. Lowering `count` or turning off the `with_*` flags also helps, because less work finishes sooner.
• 412 — The entity was not found, or a precondition failed Retrying will not help: either the entity does not exist, or the input points at a different one.
• 429 — Too many requests: a rate limit or a usage window is exhausted When the response carries an X-Retry-After header, wait that many seconds and retry: the same number is in the body as `detail.retry_after`, and the limit clears once that window passes. The message in the body names the limit that was hit.
• 500 — Something broke on our side Retrying will not help. If it keeps happening, send us the X-Request-ID from the response headers.
• 529 — Rate limit reached, or the endpoint is overloaded Wait at least 30 seconds, then retry.

Response headers

• X-Error — Error message text (present only on error)
• X-Request-ID — Unique request identifier
• X-Execution-Time — Execution time in seconds
• X-Result-Count — How many records the body carries. 0 means an empty result, which is a normal answer and not by itself an error. A non-zero count can come back together with X-Error when the failure happened partway through — read this header and X-Error independently.
• X-Total-Available-Results — How many records exist for this query, when the endpoint can say. On a `dry_run` request this is the answer and the body is empty. It saturates: the endpoint's documented maximum means 'at least that many', any smaller number is exact.
• X-Warning — Present when the request body carried keys this endpoint does not document. They were ignored, so any filter you meant to apply through them did not apply. Check the spelling against this schema and retry.
• X-Retry-After — Seconds to wait before retrying. Present only on 429.