Japan Real Estate Listings Scraper

A robust Apify Actor for scraping Japanese real estate listing metadata from HOME'S (homes.co.jp), one of Japan's largest property listing platforms operated by LIFULL Co., Ltd.

Key Features

• JSON-LD First Strategy: Extracts structured data from <script type="application/ld+json"> tags containing RealEstateListing schema, ensuring high accuracy and resilience against UI changes.
• DOM Fallback: When JSON-LD is unavailable, falls back to DOM-based extraction from property card elements.
• Japanese Price Parsing: Handles all Japanese price formats including 万円 (10,000 JPY), 億 (100,000,000 JPY), and mixed notation like 1億2,000万円.
• Comprehensive Data: Extracts price, area (m²), address, layout (間取り), built year, station access, floor details, building structure, management fees, and more.
• Rate-Limited & Polite: Built-in rate limiting (max 30 requests/minute, max concurrency 2) to respect the target site.
• Schema Validation: Every record is validated against a Zod schema before being pushed to the dataset.
• Deduplication: Automatic removal of duplicate listings by property ID.

Data Source

This actor scrapes from HOME'S (homes.co.jp), which publishes property listing metadata as structured data (JSON-LD with RealEstateListing schema). Only publicly available metadata is collected — no copyrighted content (photos, descriptions) is scraped.

Input Parameters

Parameter	Type	Default	Description
area	string	東京都	Target prefecture (e.g. 東京都, 大阪府, 神奈川県)
propertyType	enum	mansion	Property type: mansion (condo), kodate (house), tochi (land)
priceMin	integer	-	Minimum price in 万円
priceMax	integer	-	Maximum price in 万円
maxResults	integer	500	Maximum number of listings to collect
source	enum	homes	Data source (currently HOME'S only)

Output Fields

Field	Type	Description
id	string	Unique identifier (e.g. homes-1234567)
price	number	Price in 万円 (10,000 JPY units)
area	number	Floor area in m²
address	string	Property address
layout	string	Room layout (e.g. 2LDK, 3LDK)
builtYear	number	Year built (Western calendar)
source	string	Data source (homes)
sourceUrl	string	URL to original listing
station	string?	Nearest station name
walkMinutes	number?	Walking minutes to station
floor	number?	Floor number
totalFloors	number?	Total floors in building
structure	string?	Building structure (RC, SRC, etc.)
managementFee	number?	Monthly management fee (JPY)
repairReserve	number?	Monthly repair reserve fund (JPY)
balconyArea	number?	Balcony area in m²
direction	string?	Direction facing (南, 東南, etc.)
totalUnits	number?	Total units in building
agencyName	string?	Real estate agency name

Usage Example

import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: 'YOUR_TOKEN' });

const run = await client.actor('your-username/jp-realestate').call({
  area: '東京都',
  propertyType: 'mansion',
  priceMax: 5000,
  maxResults: 100,
});

const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(`Found ${items.length} listings`);

Legal Compliance

• This actor collects only publicly available property listing metadata (prices, areas, addresses).
• No copyrighted content (photos, detailed descriptions) is collected.
• Respects robots.txt directives and implements polite rate limiting.
• No personally identifiable information (PII) is collected.
• Compliant with Japan's Copyright Act Article 30-4 (TDM exception).

Pricing

Approximately $4 per 1,000 results based on Apify platform compute units.

Support

For questions or feature requests, please open an issue on the actor's GitHub repository.