# Rakumachi Scraper — Japan Investment Property & Yields (`jungle_synthesizer/rakumachi-investment-scraper`) Actor Scrape Rakumachi — Japan's #1 income-property portal. Extract price (JPY + USD), gross yield, monthly rent, occupancy, unit counts, structure. Filter by prefecture, property type, min yield, max price. - **URL**: https://apify.com/jungle\_synthesizer/rakumachi-investment-scraper.md - **Developed by:** [BowTiedRaccoon](https://apify.com/jungle_synthesizer) (community) - **Categories:** Real estate, Lead generation, Business - **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 ## Rakumachi Investment Property Scraper Scrape income-property listings from [Rakumachi](https://www.rakumachi.jp/syuuekibukken/) (楽待), Japan's #1 portal for investor-grade real estate. Returns price in JPY and USD, gross yield, monthly rent, occupancy, unit counts, building structure, and broker details for 50,000+ live 収益不動産 listings across all 47 prefectures. --- ### Rakumachi Scraper Features - Extracts 25+ fields per listing — price, gross yield, annual income, occupancy, unit count, structure, station, broker. - Converts 万円 prices to JPY and to USD at a configurable rate. Yen math is easy to get wrong, so the scraper does it for you. - Filters by prefecture, property type (1棟 / 区分 / 戸建 / land), minimum yield %, and maximum price in JPY. - Optional detail-page enrichment adds 想定年間収入, monthly rent, occupancy, floors, and broker type. - Handles pagination across all nine Rakumachi regions automatically. You pick prefectures; it walks the result pages. - Pure HTML scraping with Chrome TLS fingerprint — no browser, no proxy, no CAPTCHA. --- ### Who Uses Rakumachi Data? - **Investment funds and family offices** — Screen 50K+ listings by gross yield threshold, then shortlist for underwriting. - **Foreign investors entering Japan** — Use JPY+USD dual pricing to compare yields against home-market cap rates without pulling up a currency converter. - **Proptech and real-estate SaaS** — Feed investor-grade listings into portfolio dashboards, deal-flow tools, or DCF models. - **Broker-matching platforms** — Build lead lists of Japan-based brokers from the `broker_name` field with address, listing volume, and property-type mix. - **Research analysts** — Track yield compression across prefectures, or monitor new-listing velocity as a market-sentiment signal. --- ### How Rakumachi Scraper Works 1. Pick one or more prefectures in the input (Tokyo by default). Leave empty and it falls back to Tokyo. 2. The scraper generates a search URL per prefecture, maps it to the correct Rakumachi region, and paginates until it hits your `maxItems` cap or runs out of listings. 3. Every listing card is parsed for price, yield, address, station, units, structure, and broker. Pro-member-gated listings are skipped automatically. 4. If `scrapeDetails` is on, each listing's detail page is fetched to add annual income, occupancy rate, and broker type. --- ### Input ```json { "prefectures": ["tokyo", "osaka", "fukuoka"], "propertyType": "apartment_building", "minYieldPct": 7, "maxPriceJpy": 500000000, "scrapeDetails": true, "convertUsd": true, "usdPerJpy": 155, "maxItems": 100 } ```` | Field | Type | Default | Description | |-------|------|---------|-------------| | `prefectures` | array\[string] | `["tokyo"]` | Japanese prefectures to search. Empty falls back to Tokyo. All 47 accepted. | | `propertyType` | string | `any` | Filter by tenancy shape: `any`, `apartment_building` (1棟), `detached_rental` (戸建), `unit` (区分), `land_business`, `other`. | | `minYieldPct` | integer | `0` | Drop listings whose 表面利回り is below this value. `0` = no floor. | | `maxPriceJpy` | integer | `0` | Drop listings priced above this (in yen). `0` = no ceiling. | | `scrapeDetails` | boolean | `true` | Fetch each detail page for annual income, occupancy, and broker type. Slower. | | `convertUsd` | boolean | `true` | Add `price_usd` converted from JPY using `usdPerJpy`. | | `usdPerJpy` | integer | `155` | Conversion rate (JPY per 1 USD). Ignored when `convertUsd` is false. | | `maxItems` | integer | `100` | Maximum listings to scrape. `0` = unlimited. | *** ### Rakumachi Scraper Output Fields ```json { "listing_id": "3602259", "title": "足立区１棟店舗付レジ", "property_type": "apartment_building", "tenancy_type": "一棟", "prefecture": "tokyo", "city": "足立区", "address_ja": "東京都足立区", "price_jpy": 484800000, "price_usd": 3127742, "gross_yield_pct": 7.64, "net_yield_pct": null, "monthly_rent_jpy": 3088892, "annual_income_jpy": 37066704, "building_area_sqm": 1791.88, "land_area_sqm": 716.63, "units_total": 31, "units_occupied": 30, "occupancy_rate_pct": 96.8, "building_year": 1991, "building_age_years": 35, "building_structure": "鉄骨造", "floors": 5, "nearest_station": "日暮里舎人ライナー 舎人駅", "station_distance_min": 11, "photos": [], "description_ja": "店舗付き1棟マンション。想定年収3706万6704円、表面利回り7.64%。...", "listing_url": "https://www.rakumachi.jp/syuuekibukken/kanto/tokyo/dim1001/3602259/show.html", "broker_name": "株式会社テンポスフィナンシャルトラスト", "broker_type": "agent", "scraped_at": "2026-04-20T14:53:13.186Z" } ``` | Field | Type | Description | |-------|------|-------------| | `listing_id` | string | Rakumachi listing ID. | | `title` | string | Listing title. | | `property_type` | string | `apartment_building` / `detached_rental` / `unit` / `land_business` / `other`. | | `tenancy_type` | string | 一棟 / 区分 / 戸建 / その他. | | `prefecture` | string | Prefecture en slug (`tokyo`, `osaka`, `fukuoka`, …). | | `city` | string | City or ward, derived from the JP address. | | `address_ja` | string | Japanese address. | | `price_jpy` | number | Sale price in yen. | | `price_usd` | number | Sale price converted to USD at `usdPerJpy`. | | `gross_yield_pct` | number | Gross yield 表面利回り, annualized %. | | `net_yield_pct` | number | Net yield 実質利回り, when published. Often null — brokers don't always post it. | | `monthly_rent_jpy` | number | Assumed monthly gross rent in JPY. Detail-page only. | | `annual_income_jpy` | number | Estimated annual gross income 想定年間収入, JPY. Detail-page only. | | `building_area_sqm` | number | Building floor area in m². | | `land_area_sqm` | number | Land area in m². | | `units_total` | integer | Total units (1 for 区分 / 戸建). | | `units_occupied` | integer | Occupied units. Detail-page only. | | `occupancy_rate_pct` | number | Occupancy percentage, derived from units\_total and units\_occupied. | | `building_year` | integer | Year built. | | `building_age_years` | integer | Age in years at scrape time. | | `building_structure` | string | Structure label: 木造 / 鉄骨造 / 鉄筋コンクリート造 / 鉄骨鉄筋コンクリート造. | | `floors` | integer | Number of floors. | | `nearest_station` | string | Nearest station with line name. | | `station_distance_min` | integer | Walking minutes to the nearest station. | | `photos` | array\[string] | Listing photo URLs. | | `description_ja` | string | Japanese short description / broker blurb. | | `listing_url` | string | Rakumachi detail-page URL. | | `broker_name` | string | Listing broker / agent name. | | `broker_type` | string | `agent` (仲介) or `direct` (売主). | | `scraped_at` | string | Scrape timestamp, ISO 8601, UTC. | *** ### FAQ #### How do I scrape Rakumachi? Run Rakumachi Investment Property Scraper with a list of prefectures and an optional yield or price filter. It handles pagination, parses Japanese number formats (万円, 億円), and returns clean JSON. No Apify proxy or browser render is required. #### What's the difference between 表面利回り and 実質利回り? Gross yield (`gross_yield_pct`) is the headline number every listing publishes — annual rent divided by price. Net yield (`net_yield_pct`) accounts for expenses and is only published when the broker chooses to disclose it. Expect `net_yield_pct` to be null on most records. #### Can I filter by minimum yield? Yes. Set `minYieldPct` to your floor (e.g. `7`) and the scraper drops anything below. Pairs well with `maxPriceJpy` for quick screens like "under ¥100M with at least 8% gross yield." #### Does Rakumachi Scraper need proxies? No. The target site accepts standard requests, and the scraper ships with a Chrome TLS fingerprint. If Rakumachi ever throttles, you can add proxies in the Apify input, but the default run uses none. #### How much does Rakumachi Scraper cost to run? Rakumachi Scraper uses pay-per-event pricing: $0.10 per run start plus $0.001 per record. A 1,000-listing pull costs about $1.10. Listing-only runs are faster and cheaper — detail-page runs trade throughput for annual income and occupancy data. #### Why convert prices to USD? Because Japanese listings are quoted in 万円 (10,000-yen units) and comparing that to a cap-rate spreadsheet in USD is annoying. The scraper does the math at a rate you set, and you can disable `convertUsd` if you prefer raw JPY. *** ### Need More Features? Need custom fields, a different Japan real-estate source, or integration with your deal-flow pipeline? [File an issue](https://console.apify.com/actors/issues) or get in touch. ### Why Use Rakumachi Scraper? - **Only Japan investment-property scraper on Apify** — SUUMO and HOMES cover owner-occupier. Rakumachi covers investors. This scraper is the single source for yield-centric Japan RE data on the platform. - **Yield-centric schema** — Returns gross yield, monthly rent, annual income, and occupancy as first-class fields, so investor screens work without post-processing. Most real-estate scrapers give you square meters and a price; this one gives you the numbers a fund actually uses. - **Affordable** — $0.10 per run plus $0.001 per record. A full-Tokyo crawl of 500 listings costs under a dollar. # 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`): Japanese prefectures to search. Empty selection falls back to tokyo. ## `propertyType` (type: `string`): Filter results by tenancy / property shape. 'any' keeps all. ## `minYieldPct` (type: `integer`): Drop listings whose 表面利回り is below this value. 0 = no floor. ## `maxPriceJpy` (type: `integer`): Drop listings priced above this (in yen). 0 = no ceiling. ## `scrapeDetails` (type: `boolean`): Fetch each detail page for annual income, occupancy, and additional specs. Slower. ## `convertUsd` (type: `boolean`): Add a price\_usd field converted from JPY using usdPerJpy. ## `usdPerJpy` (type: `integer`): Conversion rate (JPY per 1 USD). Ignored when convertUsd is false. ## `maxItems` (type: `integer`): Maximum listings to scrape. 0 = unlimited. ## 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" ], "propertyType": "any", "minYieldPct": 0, "maxPriceJpy": 0, "scrapeDetails": true, "convertUsd": true, "usdPerJpy": 155, "maxItems": 100 } ``` # 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" ], "propertyType": "any", "minYieldPct": 0, "maxPriceJpy": 0, "scrapeDetails": true, "convertUsd": true, "usdPerJpy": 155, "maxItems": 100 }; // Run the Actor and wait for it to finish const run = await client.actor("jungle_synthesizer/rakumachi-investment-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"], "propertyType": "any", "minYieldPct": 0, "maxPriceJpy": 0, "scrapeDetails": True, "convertUsd": True, "usdPerJpy": 155, "maxItems": 100, } # Run the Actor and wait for it to finish run = client.actor("jungle_synthesizer/rakumachi-investment-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" ], "propertyType": "any", "minYieldPct": 0, "maxPriceJpy": 0, "scrapeDetails": true, "convertUsd": true, "usdPerJpy": 155, "maxItems": 100 }' | apify call jungle_synthesizer/rakumachi-investment-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=jungle_synthesizer/rakumachi-investment-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Rakumachi Scraper — Japan Investment Property & Yields", "description": "Scrape Rakumachi — Japan's #1 income-property portal. Extract price (JPY + USD), gross yield, monthly rent, occupancy, unit counts, structure. Filter by prefecture, property type, min yield, max price.", "version": "1.0", "x-build-id": "aJe9eHQ44kNaYDz2z" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/jungle_synthesizer~rakumachi-investment-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-jungle_synthesizer-rakumachi-investment-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~rakumachi-investment-scraper/runs": { "post": { "operationId": "runs-sync-jungle_synthesizer-rakumachi-investment-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~rakumachi-investment-scraper/run-sync": { "post": { "operationId": "run-sync-jungle_synthesizer-rakumachi-investment-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", "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": "Japanese prefectures to search. Empty selection falls back to tokyo.", "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" ] }, "default": [ "tokyo" ] }, "propertyType": { "title": "Property Type Filter", "enum": [ "any", "apartment_building", "detached_rental", "unit", "land_business", "other" ], "type": "string", "description": "Filter results by tenancy / property shape. 'any' keeps all.", "default": "any" }, "minYieldPct": { "title": "Minimum Gross Yield %", "type": "integer", "description": "Drop listings whose 表面利回り is below this value. 0 = no floor.", "default": 0 }, "maxPriceJpy": { "title": "Maximum Price (JPY)", "type": "integer", "description": "Drop listings priced above this (in yen). 0 = no ceiling.", "default": 0 }, "scrapeDetails": { "title": "Scrape Detail Pages", "type": "boolean", "description": "Fetch each detail page for annual income, occupancy, and additional specs. Slower.", "default": true }, "convertUsd": { "title": "Include USD Prices", "type": "boolean", "description": "Add a price_usd field converted from JPY using usdPerJpy.", "default": true }, "usdPerJpy": { "title": "JPY per 1 USD", "type": "integer", "description": "Conversion rate (JPY per 1 USD). Ignored when convertUsd is false.", "default": 155 }, "maxItems": { "title": "Max Items", "type": "integer", "description": "Maximum listings to scrape. 0 = unlimited.", "default": 100 } } }, "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 } } } } } } } } } } ```