# LIFULL HOMES Japan Sale Scraper — 中古マンション & 一戸建て (`jungle_synthesizer/homes-jp-sale-scraper`) Actor Scrape for-sale listings from LIFULL HOMES (homes.co.jp). Covers resale condos (中古マンション), new condos, detached homes, and land. Extracts price in JPY and USD, floor area, layout, management fees, station access, zoning, photos, and broker info. - **URL**: https://apify.com/jungle\_synthesizer/homes-jp-sale-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 ## LIFULL HOMES Japan Sale Scraper — 中古マンション & 一戸建て Scrape for-sale property listings from **LIFULL HOME'S** (`homes.co.jp`), Japan's second-largest real estate portal. Covers resale condos (中古マンション), new condos (新築マンション), resale detached homes (中古一戸建て), new detached homes (新築一戸建て), and land (土地) — by prefecture. ### What you get Each listing record contains: | Field | Description | |-------|-------------| | `listing_id` | HOMES listing ID from the URL | | `title` | Listing title (e.g. "センチュリーパークタワー 49階") | | `transaction_type` | `sale_new` / `sale_resale` / `land` | | `property_type` | `mansion_resale` / `mansion_new` / `detached_resale` / `detached_new` / `land` | | `prefecture` | Prefecture slug (e.g. `tokyo`) | | `city` | City or ward (e.g. `中央区`) | | `district` | District / chome | | `address_ja` | Full Japanese address | | `price_jpy` | Price in yen | | `price_usd` | Price in USD (converted at run time) | | `price_per_sqm_jpy` | Price per m² in yen | | `building_year` | Year built | | `building_age_years` | Age in years | | `building_area_sqm` | Floor area (m²) | | `land_area_sqm` | Land area (m²) | | `rooms_layout` | Room layout (e.g. `3LDK`) | | `direction` | Exposure direction (e.g. `南向き`) | | `building_structure` | Structure (SRC, RC, 木造, etc.) | | `floors_total` | Total floors in building | | `floor_location` | Unit floor number | | `management_fee_jpy` | Monthly management fee (yen) | | `repair_reserve_jpy` | Monthly repair reserve (yen) | | `management_company` | Property management company | | `nearest_station` | Nearest station name | | `station_distance_min` | Walk time to station (minutes) | | `train_line` | Train line name | | `zoning` | Zoning class (用途地域) | | `renovation_history` | Renovation history summary | | `photos` | Photo URLs (pipe-separated, up to 20) | | `description_ja` | Japanese listing description | | `broker_name` | Listing broker / agency name | | `listing_url` | Direct URL on homes.co.jp | | `scraped_at` | Scrape timestamp (ISO 8601) | ### Input options #### Prefectures Select one or more of Japan's 47 prefectures. Defaults to `tokyo`, `kanagawa`, `osaka`. #### Listing Category | Value | Property type | |-------|--------------| | `mansion_resale` | Resale condo (中古マンション) — **default** | | `mansion_new` | New condo (新築マンション) | | `detached_resale` | Resale detached home (中古一戸建て) | | `detached_new` | New detached home (新築一戸建て) | | `land` | Land (土地) | #### Scrape Detail Pages When enabled (default: `true`), follows each listing link to collect enriched data: station access, floor layout, management fees, building structure, zoning, renovation history, and photos. Disable for faster summary-only runs. #### Include USD Prices When enabled (default: `true`), converts the JPY price to USD using a live exchange rate fetched from `open.er-api.com` at run start. Falls back to a hardcoded rate (~149 JPY/USD) if the API is unavailable. #### Max Items Maximum listings to return. Defaults to `10`. Set to `0` for unlimited (full prefecture crawl). #### Proxy Configuration Residential proxy is strongly recommended — HOMES blocks datacenter IPs. The default configuration uses Apify's RESIDENTIAL proxy group. ### How it works 1. **Seed**: Generates listing page URLs for each selected prefecture and category (e.g. `https://www.homes.co.jp/mansion/chuko/tokyo/list/`). 2. **Listing pages**: Extracts all listings from the embedded JSON-LD `ItemList` block — price, area, year built, address, and listing URL. 3. **Detail pages** (when `scrapeDetails: true`): Follows each listing URL and parses the HTML table for station access, layout, fees, structure, zoning, photos, and broker info. 4. **Pagination**: Automatically follows next-page links until `maxItems` is reached or no more pages exist. ### Performance notes - Concurrency is capped at 3 to respect HOMES rate limits with residential proxy rotation. - A full Tokyo mansion_resale crawl (1000+ listings) takes around 30-60 minutes depending on proxy speed. - Set `scrapeDetails: false` to skip detail pages and run ~5x faster. ### Use cases - Japanese real estate market analysis - Price-per-sqm tracking across prefectures - Investment property research - Building age and structure distribution analysis - Station proximity valuation studies ### Legal notice Always comply with HOMES.co.jp's Terms of Service when using scraped data. This tool is intended for research and analysis purposes. # 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`): Prefectures to scrape. Defaults to Tokyo, Kanagawa, Osaka. ## `listingCategory` (type: `string`): Type of property to scrape. ## `scrapeDetails` (type: `boolean`): Follow listing URLs to get enriched data (station access, layout, fees, structure, photos). Slower but more complete. ## `convertUsd` (type: `boolean`): Convert JPY price to USD using a live exchange rate fetched at start. ## `maxItems` (type: `integer`): Maximum number of listings to return. Set to 0 for unlimited. ## `proxyConfiguration` (type: `object`): Residential proxy recommended — HOMES blocks datacenter IPs. ## 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" ], "listingCategory": "mansion_resale", "scrapeDetails": true, "convertUsd": true, "maxItems": 10, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } ```` # 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" ], "listingCategory": "mansion_resale", "scrapeDetails": true, "convertUsd": true, "maxItems": 10, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } }; // Run the Actor and wait for it to finish const run = await client.actor("jungle_synthesizer/homes-jp-sale-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", ], "listingCategory": "mansion_resale", "scrapeDetails": True, "convertUsd": True, "maxItems": 10, "proxyConfiguration": { "useApifyProxy": True, "apifyProxyGroups": ["RESIDENTIAL"], }, } # Run the Actor and wait for it to finish run = client.actor("jungle_synthesizer/homes-jp-sale-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" ], "listingCategory": "mansion_resale", "scrapeDetails": true, "convertUsd": true, "maxItems": 10, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } }' | apify call jungle_synthesizer/homes-jp-sale-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=jungle_synthesizer/homes-jp-sale-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "LIFULL HOMES Japan Sale Scraper — 中古マンション & 一戸建て", "description": "Scrape for-sale listings from LIFULL HOMES (homes.co.jp). Covers resale condos (中古マンション), new condos, detached homes, and land. Extracts price in JPY and USD, floor area, layout, management fees, station access, zoning, photos, and broker info.", "version": "1.0", "x-build-id": "1byCa3u8FZuFZvCuC" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/jungle_synthesizer~homes-jp-sale-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-jungle_synthesizer-homes-jp-sale-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~homes-jp-sale-scraper/runs": { "post": { "operationId": "runs-sync-jungle_synthesizer-homes-jp-sale-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~homes-jp-sale-scraper/run-sync": { "post": { "operationId": "run-sync-jungle_synthesizer-homes-jp-sale-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": "Prefectures to scrape. Defaults to Tokyo, Kanagawa, Osaka.", "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" ] } }, "listingCategory": { "title": "Listing Category", "enum": [ "mansion_resale", "mansion_new", "detached_resale", "detached_new", "land" ], "type": "string", "description": "Type of property to scrape." }, "scrapeDetails": { "title": "Scrape Detail Pages", "type": "boolean", "description": "Follow listing URLs to get enriched data (station access, layout, fees, structure, photos). Slower but more complete.", "default": true }, "convertUsd": { "title": "Include USD Prices", "type": "boolean", "description": "Convert JPY price to USD using a live exchange rate fetched at start.", "default": true }, "maxItems": { "title": "Max Items", "type": "integer", "description": "Maximum number of listings to return. Set to 0 for unlimited.", "default": 10 }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Residential proxy recommended — HOMES blocks datacenter IPs." } } }, "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 } } } } } } } } } } ```