# HOME MATE Scraper — Japan Rental Property Data & API (`sian.agency/homemate-property-scraper`) Actor HOME MATE (homemate.co.jp) scraper & real estate data API for Japan rental listings. Extract rent, layout, floor area, deposit, key money, building age, station access, lat/long geo, agent contacts & photos — clean JSON/CSV, one row per room. Fast overview or full detail. No account needed. - **URL**: https://apify.com/sian.agency/homemate-property-scraper.md - **Developed by:** [SIÁN OÜ](https://apify.com/sian.agency) (community) - **Categories:** Real estate, Automation, Lead generation - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $3.00 / 1,000 overview listing extracteds This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. 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 ## HOME MATE Scraper — Japan Rental Property Data & API 🏯 [![SIÁN Agency Store](https://img.shields.io/badge/Store-SI%C3%81N%20Agency-1AE392)](https://apify.com/sian.agency?fpr=sian) [![at home Scraper](https://img.shields.io/badge/Store-at%20home%20Scraper-1AE392)](https://apify.com/sian.agency/athome-property-scraper?fpr=sian) [![SUUMO Scraper](https://img.shields.io/badge/Store-SUUMO%20Scraper-1AE392)](https://apify.com/sian.agency/suumo-property-scraper?fpr=sian) [![Immobiliare.it Scraper](https://img.shields.io/badge/Store-Immobiliare.it%20Scraper-1AE392)](https://apify.com/sian.agency/immobiliare-property-scraper?fpr=sian) #### 🎉 Turn a major Japan rental portal into clean, structured data — one row per room, geo-located, ready for analysis ##### For real-estate analysts, investors, relocation agents, and data teams working the Japanese rental market --- ### 📋 Overview **Need Japanese rental listings as clean data instead of endless scrolling?** This scraper turns HOME MATE (homemate.co.jp) search results into structured JSON/CSV — and it does the thing most Japan property tools get wrong: it gives you **one clean row per room** *with* the data buyers actually need — price in JPY, **latitude/longitude geo**, **agent contact details**, deposit/key-money breakdown, building structure, and equipment lists. **Why analysts and agencies choose us:** - ✅ **Per-room rows**: every rentable unit becomes one clean record — no nested mess - ⚡ **Fast & lightweight**: direct extraction, no slow headless browser, no proxy overhead - 🗺️ **GPS coordinates included**: real latitude/longitude on every detail listing — map and cluster instantly - 📞 **Agent details**: agency name, address and page link — built-in lead data - 🎯 **45+ data points**: rent (normalised to JPY), 万円 raw text, layout, area, floor, deposit, key money, building age, structure, station access, equipment, photos - 💴 **Pay-per-result**: only pay for listings you actually receive — transparent and cheap - 💎 **Two depths**: fast *overview* for whole-market sweeps, full *detail* for JSON-LD + spec table - ✨ **Three ways in**: by prefecture + city code, by pasted search URL (keeps every filter), or by listing URL --- ### ✨ Features - 🏢 **Rental listings, done right** — one record per rentable room - 💴 **Money normalised** — `9.5万円` becomes `95000` JPY *and* keeps the original string - 📐 **Rent-per-m² built in** — yield and comparison math ready out of the box - 🗺️ **Geo lat/long** — every detail listing carries real coordinates for mapping - 🚉 **Station access** — every line / station / walk-time entry captured - 📞 **Agent block** — agency name, address and page link - 🧱 **Building facts** — structure, year built, total floors, total units, direction, move-in conditions - 🛠️ **Equipment lists** — kitchen, bath/toilet, in-room and building equipment, comms, security - 🔎 **Detail enrichment** — deposit, key money, key-money amortisation, other fees, rent guarantee, full photo set - 🔗 **Paste-a-URL mode** — apply filters on the site, paste the link, every supported filter is preserved - 📦 **Clean exports** — JSON, CSV, Excel straight from the dataset --- ### 🚀 How It Works 1. **Pick a scrape mode** — `overview` (fast room-level cards) or `detail` (full JSON-LD + spec table). 2. **Choose how to search** — by prefecture slug + JIS city code, by pasted search URL, or by listing URL. 3. **Set your limit** — `maxResults` caps the run. 4. **Run it** — get a clean dataset: one row per room, downloadable as JSON, CSV or Excel. **Detail mode** automatically discovers listings from the cheap search results, fetches each full page, and merges overview + detail into one enriched record — so you never pay twice for the same listing. --- ### 🧭 Input | Field | What it does | |---|---| | **🧭 Scrape mode** | `overview` (cheap room cards) or `detail` (full enriched page) | | **🔀 Search mode** | `byPlace`, `bySearchUrl`, or `byListingUrl` (detail only) | | **📍 Prefecture slugs** | e.g. `tokyo`, `osaka`, `kanagawa` — paired with city codes | | **🏙️ JIS city codes** | e.g. `13104` (Shinjuku), `27100` (Osaka City) | | **🔗 Search URLs** | Paste a homemate.co.jp city result URL — your filters ride along | | **🏠 Listing URLs** | Paste detail URLs or bare listing codes (detail mode) | | **🔢 Max results** | Listings per run — FREE up to 25, PAID unlimited | | **🌐 Use Japan proxy** | Optional residential proxy (off by default) | #### Example input ```json { "scrapeMode": "detail", "searchMode": "byPlace", "places": ["tokyo"], "cities": ["13104"], "maxResults": 100 } ```` *** ### 📦 Output Each row is one rentable room. Sample (trimmed): ```json { "thumbnail": "https://apic.homemate.co.jp/ice/...jpg", "listingId": "203351591101", "url": "https://www.homemate.co.jp/dtl-203351591101/", "source": "detail", "propertyTitle": "クレア上落合 1階101", "property_type": "マンション", "layout": "1K", "price": 95000, "currency": "JPY", "price_per_sqm_jpy": 3733, "price_formatted": "9.5万円", "common_fee": 3000, "deposit": "9.5万円", "key_money": "9.5万円", "area_m2": 25.45, "floor": "1階", "total_floors": "3階建", "structure": "鉄骨造", "building_age": "築15年", "address": "東京都新宿区上落合...", "postal_code": "161-0034", "latitude": 35.71, "longitude": 139.69, "station": "中井駅", "line": "都営大江戸線", "walk_min": 5, "agent_name": "ホームメイト 新宿店", "equipment": ["バス・トイレ別", "オートロック", "..."], "image_count": 65 } ``` Full field set includes building name, total units, direction, move-in, entry conditions, transaction type, contract form, rent guarantee, key-money amortisation, other fees, transit lines, feature tags, full image gallery, and run metadata. *** ### 💴 Pricing **Pay-per-result** — you pay only for the listings you actually receive, plus a small one-time run fee. - **OverviewListingExtracted** — charged per room card in overview mode (the cheap, high-volume path). - **DetailListingExtracted** — charged per fully-enriched listing in detail mode (JSON-LD + spec table). **FREE users** can extract up to 25 listings per run to try it out. **PAID users** get unlimited listings and the lowest per-listing rates. *** ### ❓ FAQ **Do I need an account or API key for HOME MATE?** No. Just run the actor — no login, no key. **Overview vs detail — which should I use?** Use **overview** for fast whole-market sweeps (rent, layout, area, station, deposit/key money). Use **detail** when you need geo coordinates, building structure, equipment lists, conditions, agent info, and the full photo set. **Can I keep my own filters?** Yes — apply filters (rent range, sort, building type) on homemate.co.jp, then paste the resulting URL into **Search URLs**. Every supported filter is preserved. **What currency are prices in?** Japanese Yen (JPY). The `万円` display text is normalised to an integer JPY `price`, and the original string is kept in `price_formatted`. *** ### 🔗 More by SIÁN Agency - [at home Scraper](https://apify.com/sian.agency/athome-property-scraper?fpr=sian) — Japan rental property data & API - [SUUMO Scraper](https://apify.com/sian.agency/suumo-property-scraper?fpr=sian) — Japan's #1 property portal - [Immobiliare.it Scraper](https://apify.com/sian.agency/immobiliare-property-scraper?fpr=sian) — Italy property data & API - [Browse all SIÁN actors →](https://apify.com/sian.agency?fpr=sian) ⭐ **Love this actor?** Leave a [5-star review](https://apify.com/sian.agency/homemate-property-scraper/reviews) — it helps us build more features for you. *** > **Disclaimer:** This is an independent tool and is not affiliated with, endorsed by, or sponsored by HOME MATE or its operator. "HOME MATE" (ホームメイト) and homemate.co.jp are trademarks of their respective owners. Use this actor in compliance with the source site's terms of service and all applicable laws. # Actor input Schema ## `scrapeMode` (type: `string`): 🧭 **OVERVIEW** (cheap, primary): room-level cards from the search results — one row per rentable unit, with rent, layout, area, station access & deposit/key money. 🔎 **DETAIL** (enrich): fetches each listing's full page (JSON-LD + spec table) for price in JPY, geo lat/long, building structure, year built, direction, move-in conditions, equipment, agent contacts & full image set. Detail merges overview + detail into one record. ## `searchMode` (type: `string`): 🔀 How listings are discovered. - **byPlace** — give one or more HOME MATE prefecture slugs (e.g. `tokyo`) paired with JIS city codes (e.g. `13104` = Shinjuku). - **bySearchUrl** — paste a ready-made HOME MATE search URL with your filters applied in the UI (most reliable). - **byListingUrl** — fetch specific listings directly (DETAIL only). ## `places` (type: `array`): 📍 **BY PREFECTURE:** HOME MATE prefecture slugs to scrape. Examples: `tokyo`, `osaka`, `kanagawa`, `aichi`, `fukuoka`. Paired by position with `cities`. Builds `/pr-{prefecture}/{cityCode}/`. 💡 **TIP:** For precise filtering, use **bySearchUrl** instead — apply your filters in HOME MATE's UI and paste the URL. ## `cities` (type: `array`): 🏙️ **BY PREFECTURE:** 5-digit JIS municipal codes paired with `places` by position (e.g. `13104` = Shinjuku, `27100` = Osaka City). Builds `/pr-{prefecture}/{cityCode}/`. Find the code in any HOME MATE city result URL. ## `searchUrls` (type: `array`): 🔗 **BY SEARCH URL:** Paste one or more homemate.co.jp city result-list URLs (the `/pr-{pref}/{cityCode}/` pages). Apply all your filters (rent bounds, sort, building type) in the HOME MATE UI first, then copy the address — every supported filter query param is preserved. ## `listingUrls` (type: `array`): 🏠 **BY LISTING URL (DETAIL ONLY):** Paste HOME MATE detail URLs (e.g. `https://www.homemate.co.jp/dtl-203351591101/`) or bare bukken codes. Used with scrapeMode = detail. ## `maxResults` (type: `integer`): 🔢 Maximum listings to return per run. **FREE users:** capped at 25 · **PAID users:** unlimited. ## `useProxy` (type: `boolean`): 🌐 Route requests through a Japan residential proxy. **Off by default** — homemate.co.jp is reachable without a proxy, so leaving this off keeps runs fast and cheap. Enable only if you hit a soft per-IP rate-gate at scale. ## Actor input object example ```json { "scrapeMode": "overview", "searchMode": "byPlace", "places": [ "tokyo" ], "cities": [ "13104" ], "maxResults": 100, "useProxy": false } ``` # Actor output Schema ## `results` (type: `string`): All scraped HOME MATE listings as a clean JSON/CSV dataset. # 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 = {}; // Run the Actor and wait for it to finish const run = await client.actor("sian.agency/homemate-property-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 = {} # Run the Actor and wait for it to finish run = client.actor("sian.agency/homemate-property-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 '{}' | apify call sian.agency/homemate-property-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=sian.agency/homemate-property-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "HOME MATE Scraper — Japan Rental Property Data & API", "description": "HOME MATE (homemate.co.jp) scraper & real estate data API for Japan rental listings. Extract rent, layout, floor area, deposit, key money, building age, station access, lat/long geo, agent contacts & photos — clean JSON/CSV, one row per room. Fast overview or full detail. No account needed.", "version": "1.0", "x-build-id": "jO1npHeEjnRZwWDYN" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/sian.agency~homemate-property-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-sian.agency-homemate-property-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/sian.agency~homemate-property-scraper/runs": { "post": { "operationId": "runs-sync-sian.agency-homemate-property-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/sian.agency~homemate-property-scraper/run-sync": { "post": { "operationId": "run-sync-sian.agency-homemate-property-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": { "scrapeMode": { "title": "🧭 Scrape mode", "enum": [ "overview", "detail" ], "type": "string", "description": "🧭 **OVERVIEW** (cheap, primary): room-level cards from the search results — one row per rentable unit, with rent, layout, area, station access & deposit/key money.\n\n🔎 **DETAIL** (enrich): fetches each listing's full page (JSON-LD + spec table) for price in JPY, geo lat/long, building structure, year built, direction, move-in conditions, equipment, agent contacts & full image set. Detail merges overview + detail into one record.", "default": "overview" }, "searchMode": { "title": "🔀 Search mode", "enum": [ "byPlace", "bySearchUrl", "byListingUrl" ], "type": "string", "description": "🔀 How listings are discovered.\n\n- **byPlace** — give one or more HOME MATE prefecture slugs (e.g. `tokyo`) paired with JIS city codes (e.g. `13104` = Shinjuku).\n- **bySearchUrl** — paste a ready-made HOME MATE search URL with your filters applied in the UI (most reliable).\n- **byListingUrl** — fetch specific listings directly (DETAIL only).", "default": "byPlace" }, "places": { "title": "📍 Prefecture slugs", "type": "array", "description": "📍 **BY PREFECTURE:** HOME MATE prefecture slugs to scrape. Examples: `tokyo`, `osaka`, `kanagawa`, `aichi`, `fukuoka`. Paired by position with `cities`. Builds `/pr-{prefecture}/{cityCode}/`.\n\n💡 **TIP:** For precise filtering, use **bySearchUrl** instead — apply your filters in HOME MATE's UI and paste the URL.", "default": [ "tokyo" ], "items": { "type": "string" } }, "cities": { "title": "🏙️ JIS city codes", "type": "array", "description": "🏙️ **BY PREFECTURE:** 5-digit JIS municipal codes paired with `places` by position (e.g. `13104` = Shinjuku, `27100` = Osaka City). Builds `/pr-{prefecture}/{cityCode}/`. Find the code in any HOME MATE city result URL.", "default": [ "13104" ], "items": { "type": "string" } }, "searchUrls": { "title": "🔗 Search URLs", "type": "array", "description": "🔗 **BY SEARCH URL:** Paste one or more homemate.co.jp city result-list URLs (the `/pr-{pref}/{cityCode}/` pages). Apply all your filters (rent bounds, sort, building type) in the HOME MATE UI first, then copy the address — every supported filter query param is preserved.", "items": { "type": "string" } }, "listingUrls": { "title": "🏠 Listing URLs", "type": "array", "description": "🏠 **BY LISTING URL (DETAIL ONLY):** Paste HOME MATE detail URLs (e.g. `https://www.homemate.co.jp/dtl-203351591101/`) or bare bukken codes. Used with scrapeMode = detail.", "items": { "type": "string" } }, "maxResults": { "title": "🔢 Max results", "minimum": 1, "type": "integer", "description": "🔢 Maximum listings to return per run. **FREE users:** capped at 25 · **PAID users:** unlimited.", "default": 100 }, "useProxy": { "title": "🌐 Use Japan residential proxy", "type": "boolean", "description": "🌐 Route requests through a Japan residential proxy. **Off by default** — homemate.co.jp is reachable without a proxy, so leaving this off keeps runs fast and cheap. Enable only if you hit a soft per-IP rate-gate at scale.", "default": 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 } } }, "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 } } } } } } } } } } ```