{ "openapi": "3.0.1", "info": { "title": "MLIT Japan Real Estate Transaction Prices", "description": "Extract official Japanese real estate transaction prices from the MLIT government API. Covers all 47 prefectures from 2005 onward with 29 data fields including price, area, building age, layout, and zoning. English and Japanese output. Free API key required.", "version": "1.0", "x-build-id": "1PHfBcAqckrmTwSfD" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/rationalistic_counsel~mlit-japan-real-estate-prices/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-rationalistic_counsel-mlit-japan-real-estate-prices", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/rationalistic_counsel~mlit-japan-real-estate-prices/runs": { "post": { "operationId": "runs-sync-rationalistic_counsel-mlit-japan-real-estate-prices", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/rationalistic_counsel~mlit-japan-real-estate-prices/run-sync": { "post": { "operationId": "run-sync-rationalistic_counsel-mlit-japan-real-estate-prices", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "required": [ "apiKey" ], "properties": { "apiKey": { "title": "MLIT API Key", "type": "string", "description": "Your MLIT Real Estate Information Library API Subscription Key. This is free — apply at reinfolib.mlit.go.jp/api/request. Approval takes approximately 5 business days." }, "searchMode": { "title": "Search Mode", "enum": [ "area", "bulk" ], "type": "string", "description": "Search a specific area (prefecture or municipality), or download all prefectures in bulk.", "default": "area" }, "areaQuery": { "title": "Area", "type": "string", "description": "Prefecture code (e.g., '13' for Tokyo), municipality code (e.g., '13101' for Chiyoda Ward), or prefecture name in English or Japanese (e.g., 'Tokyo', '東京都'). Required for Area search mode." }, "propertyTypes": { "title": "Property Types", "type": "array", "description": "Filter by property type. Leave empty to return all types.", "items": { "type": "string", "enum": [ "residential_land", "residential_land_building", "pre_owned_condo", "commercial_land", "agricultural_land", "forest_land" ], "enumTitles": [ "Residential Land (住宅地)", "Residential Land & Building (宅地(土地と建物))", "Pre-Owned Condos & Similar (中古マンション等)", "Commercial Land (商業地)", "Agricultural Land (農地)", "Forest Land (林地)" ] }, "default": [] }, "yearFrom": { "title": "Year From", "minimum": 2005, "maximum": 2030, "type": "integer", "description": "Start year for the search range. Earliest available is 2005." }, "quarterFrom": { "title": "Quarter From", "enum": [ "1", "2", "3", "4" ], "type": "string", "description": "Start quarter (1-4). Data starts from Q3 2005.", "default": "1" }, "yearTo": { "title": "Year To", "minimum": 2005, "maximum": 2030, "type": "integer", "description": "End year for the search range." }, "quarterTo": { "title": "Quarter To", "enum": [ "1", "2", "3", "4" ], "type": "string", "description": "End quarter (1-4).", "default": "4" }, "language": { "title": "Language", "enum": [ "en", "ja" ], "type": "string", "description": "Output language. English returns translated field values (property types, locations, etc.).", "default": "en" }, "maxResults": { "title": "Max Results", "minimum": 1, "maximum": 100000, "type": "integer", "description": "Maximum number of transactions to return. Higher values require more API calls (rate-limited to 1 call per 3 seconds).", "default": 1000 } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } }