# Japan Court Auction (BIT) Scraper — Foreclosure Listings (`jungle_synthesizer/bit-japan-court-auction-scraper`) Actor Scrape Japan's official court auction database (BIT / 不動産競売物件情報サイト) — all 50 district courts. Extracts case numbers, addresses, property types, areas, bid prices, deadlines, and 3-point-set PDF links for below-market foreclosure listings. - **URL**: https://apify.com/jungle\_synthesizer/bit-japan-court-auction-scraper.md - **Developed by:** [BowTiedRaccoon](https://apify.com/jungle_synthesizer) (community) - **Categories:** Real estate, Lead generation, Developer tools - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing Pay per event This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## Japan Court Auction (BIT) Scraper — Foreclosure Listings Scrapes Japan's official court auction database, BIT (不動産競売物件情報サイト), operated by the Supreme Court of Japan. Covers all 50 district courts across all 47 prefectures and extracts structured listing data including case numbers, addresses, bid prices, deadlines, and optional 3-point-set PDF links. ### What BIT Is BIT is the official public database for court-ordered foreclosure auctions in Japan. Properties are sold through a transparent bidding process administered by district courts. Listings typically appear at 60–80% of appraised value — making them attractive to investors, real estate professionals, and due-diligence researchers. Each listing is accompanied by a 3-point-set PDF bundle (物件明細書, 現況調査報告書, 評価書) containing title details, current status, and valuation reports. ### What This Actor Extracts For each foreclosure listing: | Field | Description | |-------|-------------| | `case_number` | Court case number (事件番号), e.g. 令和07年(ケ)第270号 | | `court_name` | District court name | | `court_branch` | Branch name (支部); empty for main court | | `prefecture` | Prefecture slug (e.g. `tokyo`, `osaka`) | | `city` | City / ward / town | | `address_ja` | Full Japanese address | | `postal_code` | 7-digit postal code | | `latitude` / `longitude` | Geocoordinates from map embed | | `property_type` | land / house / land\_house / mansion\_unit / apartment / other | | `land_area_sqm` | Land area in m² | | `building_area_sqm` | Building floor area in m² | | `building_year` | Year constructed | | `building_age_years` | Building age in years | | `building_structure` | Structure type (木造, RC, 鉄骨, etc.) | | `floors` | Number of floors | | `rooms_layout` | Room layout, e.g. 3LDK | | `zoning` | Zoning classification | | `min_sale_price_jpy` | Reserve price 売却基準価額 (JPY) | | `min_bid_price_jpy` | Minimum bid 買受可能価額 (JPY) | | `deposit_required_jpy` | Required deposit 買受申出保証金 (JPY) | | `bid_period_start` | Bid window start (YYYY-MM-DD) | | `bid_period_end` | Bid window end (YYYY-MM-DD) | | `opening_date` | Announcement date 開札期日 (YYYY-MM-DD) | | `sale_round` | Auction round (1 = first, 2 = special sale) | | `occupancy_status` | vacant / tenanted / owner\_occupied / unknown | | `three_point_set_url` | URL for 3-point-set PDF bundle | | `photos` | Listing photo URLs (pipe-separated) | | `listing_url` | Direct URL to BIT detail page | | `scraped_at` | Scrape timestamp (ISO 8601 UTC) | ### Input Parameters | Parameter | Type | Description | |-----------|------|-------------| | `prefectures` | array | Prefecture slugs to scrape (`tokyo`, `osaka`, etc.). Empty = all 47. | | `maxItems` | integer | Maximum results. 0 = unlimited. | | `downloadThreePointSet` | boolean | Download and summarize 3-point-set PDFs. Slower but extracts occupancy, defects, and valuation detail. | | `proxyConfiguration` | object | Proxy settings. JP residential proxy recommended. | #### Prefecture Slugs All 47 prefectures are supported: `hokkaido`, `aomori`, `iwate`, `miyagi`, `akita`, `yamagata`, `fukushima`, `ibaraki`, `tochigi`, `gunma`, `saitama`, `chiba`, `tokyo`, `kanagawa`, `niigata`, `toyama`, `ishikawa`, `fukui`, `yamanashi`, `nagano`, `gifu`, `shizuoka`, `aichi`, `mie`, `shiga`, `kyoto`, `osaka`, `hyogo`, `nara`, `wakayama`, `tottori`, `shimane`, `okayama`, `hiroshima`, `yamaguchi`, `tokushima`, `kagawa`, `ehime`, `kochi`, `fukuoka`, `saga`, `nagasaki`, `kumamoto`, `oita`, `miyazaki`, `kagoshima`, `okinawa`. ### Example Output ```json { "case_number": "令和07年(ケ)第270号", "court_name": "東京地方裁判所", "court_branch": "", "prefecture": "tokyo", "city": "目黒区", "address_ja": "東京都目黒区中町二丁目", "postal_code": "153-0065", "latitude": 35.632, "longitude": 139.693, "property_type": "mansion_unit", "land_area_sqm": null, "building_area_sqm": 58.32, "building_age_years": 28, "building_year": 1997, "building_structure": "鉄筋コンクリート造", "floors": 14, "rooms_layout": "2LDK", "zoning": "第一種住居地域", "min_sale_price_jpy": 32000000, "min_bid_price_jpy": 25600000, "deposit_required_jpy": 6400000, "bid_period_start": "2026-05-12", "bid_period_end": "2026-05-19", "opening_date": "2026-05-26", "sale_round": 1, "occupancy_status": "vacant", "three_point_set_url": "https://www.bit.courts.go.jp/app/detail/pd001/h04?courtId=31111&saleUnitId=00001234567", "photos": "https://www.bit.courts.go.jp/data/image/...", "listing_url": "https://www.bit.courts.go.jp/app/propertyresult/pr001/h05?saleUnitId=00001234567&courtId=31111", "scraped_at": "2026-05-18T10:00:00.000Z" } ```` ### How It Works 1. Fetches the BIT schedule index listing all district courts 2. Filters courts by requested prefectures (using the court ID to prefecture mapping embedded in the index) 3. For each court, reads the upcoming auction schedule 4. POSTs to the results listing endpoint for each scheduled auction period 5. Fetches the full detail page for each listing 6. Optionally checks the 3-point-set PDF availability The actor uses a residential Japanese IP proxy to ensure reliable access to the government server. Rate limiting (300ms between GET requests, 800ms between POST requests) prevents overloading the court system. ### Notes - BIT only lists **active** auctions — concluded sales and historical data are not available - Some listings appear multiple times with different `case_number` entries when a case has multiple properties - `sale_round: 2` indicates a "special sale" (特別売却) — a second-chance auction at a lower price - The 3-point-set PDFs require a separate download session; set `downloadThreePointSet: true` for occupancy and defect details - Japanese dates (和暦 era dates) are automatically converted to Gregorian (YYYY-MM-DD) - Dates are 和暦 on the BIT pages: 令和 = 2018+year, 平成 = 1988+year, 昭和 = 1925+year # Actor input Schema ## `sp_intended_usage` (type: `string`): Please describe how you plan to use the data extracted by this crawler. ## `sp_improvement_suggestions` (type: `string`): Provide any feedback or suggestions for improvements. ## `sp_contact` (type: `string`): Provide your email address so we can get in touch with you. ## `prefectures` (type: `array`): List of Japanese prefectures to search (English slug). Empty = all 47. ## `downloadThreePointSet` (type: `boolean`): Download and parse 物件明細書, 現況調査報告書, 評価書 for each listing. Slower but unlocks occupancy, defects, and valuation detail. ## `maxItems` (type: `integer`): Maximum number of listings to return. Set 0 for unlimited. ## `proxyConfiguration` (type: `object`): BIT is a Japanese government site. Residential JP proxy recommended. ## Actor input object example ```json { "sp_intended_usage": "Describe your intended use...", "sp_improvement_suggestions": "Share your suggestions here...", "sp_contact": "Share your email here...", "prefectures": [ "tokyo", "kanagawa", "osaka" ], "downloadThreePointSet": false, "maxItems": 10, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "JP" } } ``` # Actor output Schema ## `results` (type: `string`): No description # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "sp_intended_usage": "Describe your intended use...", "sp_improvement_suggestions": "Share your suggestions here...", "sp_contact": "Share your email here...", "prefectures": [ "tokyo", "kanagawa", "osaka" ], "downloadThreePointSet": false, "maxItems": 10, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "JP" } }; // Run the Actor and wait for it to finish const run = await client.actor("jungle_synthesizer/bit-japan-court-auction-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "sp_intended_usage": "Describe your intended use...", "sp_improvement_suggestions": "Share your suggestions here...", "sp_contact": "Share your email here...", "prefectures": [ "tokyo", "kanagawa", "osaka", ], "downloadThreePointSet": False, "maxItems": 10, "proxyConfiguration": { "useApifyProxy": True, "apifyProxyGroups": ["RESIDENTIAL"], "apifyProxyCountry": "JP", }, } # Run the Actor and wait for it to finish run = client.actor("jungle_synthesizer/bit-japan-court-auction-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "sp_intended_usage": "Describe your intended use...", "sp_improvement_suggestions": "Share your suggestions here...", "sp_contact": "Share your email here...", "prefectures": [ "tokyo", "kanagawa", "osaka" ], "downloadThreePointSet": false, "maxItems": 10, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "JP" } }' | apify call jungle_synthesizer/bit-japan-court-auction-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=jungle_synthesizer/bit-japan-court-auction-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Japan Court Auction (BIT) Scraper — Foreclosure Listings", "description": "Scrape Japan's official court auction database (BIT / 不動産競売物件情報サイト) — all 50 district courts. Extracts case numbers, addresses, property types, areas, bid prices, deadlines, and 3-point-set PDF links for below-market foreclosure listings.", "version": "1.0", "x-build-id": "9fy41OBJ4gSJzfSO6" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/jungle_synthesizer~bit-japan-court-auction-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-jungle_synthesizer-bit-japan-court-auction-scraper", "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/jungle_synthesizer~bit-japan-court-auction-scraper/runs": { "post": { "operationId": "runs-sync-jungle_synthesizer-bit-japan-court-auction-scraper", "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/jungle_synthesizer~bit-japan-court-auction-scraper/run-sync": { "post": { "operationId": "run-sync-jungle_synthesizer-bit-japan-court-auction-scraper", "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": [ "sp_intended_usage", "sp_improvement_suggestions" ], "properties": { "sp_intended_usage": { "title": "What is the intended usage of this data?", "minLength": 1, "type": "string", "description": "Please describe how you plan to use the data extracted by this crawler." }, "sp_improvement_suggestions": { "title": "How can we improve this crawler for you?", "minLength": 1, "type": "string", "description": "Provide any feedback or suggestions for improvements." }, "sp_contact": { "title": "Contact Email", "minLength": 1, "type": "string", "description": "Provide your email address so we can get in touch with you." }, "prefectures": { "title": "Prefectures", "type": "array", "description": "List of Japanese prefectures to search (English slug). Empty = all 47.", "items": { "type": "string", "enum": [ "hokkaido", "aomori", "iwate", "miyagi", "akita", "yamagata", "fukushima", "ibaraki", "tochigi", "gunma", "saitama", "chiba", "tokyo", "kanagawa", "niigata", "toyama", "ishikawa", "fukui", "yamanashi", "nagano", "gifu", "shizuoka", "aichi", "mie", "shiga", "kyoto", "osaka", "hyogo", "nara", "wakayama", "tottori", "shimane", "okayama", "hiroshima", "yamaguchi", "tokushima", "kagawa", "ehime", "kochi", "fukuoka", "saga", "nagasaki", "kumamoto", "oita", "miyazaki", "kagoshima", "okinawa" ] } }, "downloadThreePointSet": { "title": "Download 3-Point Set PDFs", "type": "boolean", "description": "Download and parse 物件明細書, 現況調査報告書, 評価書 for each listing. Slower but unlocks occupancy, defects, and valuation detail.", "default": false }, "maxItems": { "title": "Max Items", "type": "integer", "description": "Maximum number of listings to return. Set 0 for unlimited.", "default": 10 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "BIT is a Japanese government site. Residential JP proxy recommended." } } }, "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 } } } } } } } } } } ```