{ "openapi": "3.0.1", "info": { "title": "Japan Tax Auction Real Estate – NTA Public Auction", "description": "Real estate and farmland seized for unpaid national taxes and sold by Japan's National Tax Agency (国税庁 公売): estimated price, bidding period, deposit, method of sale, property type, land use, area, prefecture and municipality, with new-listing and price-change tracking. Property facts only.", "version": "0.0", "x-build-id": "6wSlULj173iO8EbkO" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/datalab-jp~japan-nta-public-auction/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-datalab-jp-japan-nta-public-auction", "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/datalab-jp~japan-nta-public-auction/runs": { "post": { "operationId": "runs-sync-datalab-jp-japan-nta-public-auction", "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/datalab-jp~japan-nta-public-auction/run-sync": { "post": { "operationId": "run-sync-datalab-jp-japan-nta-public-auction", "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", "properties": { "propertyTypes": { "title": "Property types", "uniqueItems": true, "type": "array", "description": "Which kinds of seized real estate to return, e.g. ['land_with_building', 'condominium_unit'] for houses and flats or ['farmland'] for agricultural land. Values: land_with_building (土地付建物), condominium_unit (区分所有建物), building (建物), land (土地, excluding farmland), farmland (農地) and other_real_estate (その他不動産). Defaults to all six when omitted or empty, read in that order. Farmland cannot be bought without a farmland permit (see isFarmland and farmlandCertificateRequired in the output).", "items": { "type": "string", "enum": [ "land_with_building", "condominium_unit", "building", "land", "farmland", "other_real_estate" ], "enumTitles": [ "Land with building (土地付建物)", "Condominium unit (区分所有建物)", "Building only (建物)", "Land, not farmland (土地)", "Farmland (農地)", "Other real estate (その他不動産)" ] }, "default": [ "land_with_building", "condominium_unit", "building", "land", "farmland", "other_real_estate" ] }, "prefectures": { "title": "Prefectures", "type": "array", "description": "Only return properties in these prefectures, e.g. ['Tokyo', 'Kanagawa'] or ['千葉県', '埼玉']. English names (Hokkaido, Osaka, Okinawa …) and Japanese names with or without 都/道/府/県 both work. Defaults to the whole country when omitted or empty. The whole of Japan typically has only about 150 tax-auction listings at a time, so a single prefecture often has none; RUN_REPORT says so when that happens.", "items": { "type": "string" }, "default": [] }, "taxBureaus": { "title": "Regional taxation bureaus", "uniqueItems": true, "type": "array", "description": "Only return properties sold by these regional taxation bureaus, e.g. ['tokyo'] or ['kanto-shinetsu', 'nagoya']. Values: tokyo, kanto-shinetsu, osaka, sapporo, sendai, nagoya, kanazawa, hiroshima, takamatsu, fukuoka, kumamoto, okinawa. Defaults to all bureaus when omitted or empty. A bureau covers several prefectures (kanto-shinetsu = Ibaraki, Tochigi, Gunma, Saitama, Niigata, Nagano); use prefectures for a finer filter.", "items": { "type": "string", "enum": [ "tokyo", "kanto-shinetsu", "osaka", "sapporo", "sendai", "nagoya", "kanazawa", "hiroshima", "takamatsu", "fukuoka", "kumamoto", "okinawa" ], "enumTitles": [ "Tokyo (東京国税局)", "Kanto-Shinetsu (関東信越国税局)", "Osaka (大阪国税局)", "Sapporo (札幌国税局)", "Sendai (仙台国税局)", "Nagoya (名古屋国税局)", "Kanazawa (金沢国税局)", "Hiroshima (広島国税局)", "Takamatsu (高松国税局)", "Fukuoka (福岡国税局)", "Kumamoto (熊本国税局)", "Okinawa (沖縄国税事務所)" ] }, "default": [] }, "minPriceJpy": { "title": "Minimum estimated price (JPY)", "minimum": 0, "type": "integer", "description": "Only return properties whose estimated price (見積価額, the minimum bid) is at least this many yen, e.g. 1000000 (¥1M) or 5000000 (¥5M). Whole yen, no commas or currency signs. Leave empty for no lower limit (default). Combine with maxPriceJpy for a price band." }, "maxPriceJpy": { "title": "Maximum estimated price (JPY)", "minimum": 0, "type": "integer", "description": "Only return properties whose estimated price (見積価額) is at most this many yen, e.g. 3000000 (¥3M) or 20000000 (¥20M). Whole yen, no commas or currency signs. Leave empty for no upper limit (default). Many rural plots start below ¥500,000, while houses in cities can exceed ¥100M." }, "maxItems": { "title": "Max results", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Maximum number of property rows returned, e.g. 20 for a quick look or 1000 for every current listing (about 150 nationwide on 2026-10-10). Each returned row is one billable result, so this is your main cost control. Defaults to 20 when omitted; accepts 1–1000. With change tracking on, set it high enough to cover all matching listings, otherwise listings beyond the cap are reported as new on a later run.", "default": 20 }, "includeDetails": { "title": "Include bidding dates and deposit", "type": "boolean", "description": "Reads each listing's official notice page to add the bidding period, bid-opening date, deposit, sale-unit number, notice number, payment deadline, nearest station and the farmland-certificate flag, e.g. true for bidding calendars or false for a fast price/area list. Costs nothing extra but adds one page request per returned row. Defaults to true when omitted. Rows whose notice page fails keep the list-level fields and show detailFetched=false.", "default": true }, "changeTracking": { "title": "Change tracking (new listings)", "enum": [ "off", "all_with_flags", "new_only" ], "type": "string", "description": "Compares this run with the snapshot saved by your previous run, e.g. 'new_only' for a weekly new-listing alert or 'all_with_flags' for the full list with a changeType column. 'off' saves nothing; 'all_with_flags' returns every row with changeType first_run/new/price_changed/unchanged; 'new_only' returns everything on the first run, afterwards only new and re-priced listings. Defaults to 'off'. Listings that left the site go to the CHANGES record.", "default": "off" }, "stateStoreName": { "title": "Snapshot store name", "type": "string", "description": "Name of the key-value store in your Apify account where the change-tracking snapshot is kept, e.g. 'japan-nta-public-auction-state' or 'tokyo-houses-weekly'. Letters, digits and hyphens only (max 63). Defaults to 'japan-nta-public-auction-state'. Only used when changeTracking is not 'off'; each combination of property types and filters keeps its own snapshot inside the store.", "default": "japan-nta-public-auction-state" }, "maxConcurrency": { "title": "Parallel requests", "minimum": 1, "maximum": 3, "type": "integer", "description": "How many notice pages are requested at the same time, e.g. 2 (default) or 1 for the gentlest crawl. This is a government website, so the limit is deliberately low. Defaults to 2 when omitted; accepts 1–3. Each worker also pauses 0.5 s after every page.", "default": 2 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Proxy settings, e.g. no proxy (default) or Apify Proxy with Japanese residential IPs. The NTA site answered direct requests, including from Apify's datacenter IPs, when tested in October 2026, so no proxy is needed. Defaults to a direct connection when omitted. If you enable Apify Proxy without choosing a group, Japanese residential IPs are used as a precaution.", "default": { "useApifyProxy": false } } } }, "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 }, "PROXY_UNBLOCKER_UNITS": { "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 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }