SUUMO Scraper

Scrape real-estate listings from suumo.jp — Japan's largest real-estate portal, operated by Recruit — covering used condos, new houses, used houses and land for sale across all 47 prefectures.

What does this actor do?

SUUMO Scraper searches suumo.jp by property type, prefecture, price and floor area, returning structured listing data — no login, no API key required. It reads suumo.jp's public, server-rendered listing pages directly.

Output data

Each result is a JSON record with (where available):

• title, propertyName, listingId
• priceRaw (original Japanese text, e.g. 2980万円), priceJpy (parsed numeric yen value), priceCurrency (JPY)
• address, stationAccess (nearest train line/station and walking time), walkMinutes (parsed walk time in minutes)
• floorAreaRaw, floorAreaSqm (parsed square meters) — floor area for condos/houses, land area for land listings
• layout (room layout, e.g. 3LDK)
• balconyAreaRaw, balconyAreaSqm
• builtDateRaw, builtYear (parsed construction year)
• imageUrl
• propertyType, prefecture
• sourceUrl / detailUrl, recordType, scrapedAt

Fields that suumo.jp doesn't provide for a given listing are simply omitted — you'll never see null or empty placeholders.

Input options

Field	Description
propertyType	usedCondo, newHouse, usedHouse, or land
prefecture	Any of Japan's 47 prefectures
priceMinJpy / priceMaxJpy	Price range in Japanese yen
floorAreaMinSqm / floorAreaMaxSqm	Floor/land area range in square meters
builtYearMin	Drop listings built before this year
layoutCategory	(not land) Room-layout category: studio, 1K/DK/LDK, 2K/DK/LDK, 3K/DK/LDK, 4K/DK/LDK, or 5K and more
maxWalkMinutes	Only keep listings within this many minutes' walk of the nearest station
sortBy	Sort order: newest, price (asc/desc), floor area (asc/desc), layout (fewest/most rooms), built date (oldest/newest)
keyword	Only keep listings whose property name/title/address/layout contains this text
maxItems	Maximum number of listings to return

Example input

{
  "propertyType": "usedCondo",
  "prefecture": "tokyo",
  "priceMaxJpy": 50000000,
  "maxItems": 30
}

Use cases

• Market research — track average prices per prefecture or property type over time.
• Investment screening — filter by price and floor area to find undervalued properties.
• Relocation planning — compare listings and station access across prefectures.
• Land development scouting — filter land listings by area and price.

FAQ

Does this require a suumo.jp account or API key? No. The actor reads suumo.jp's public listing search pages directly.

Can I search for rental properties, new-build condos, or custom-order houses? Not currently. This actor covers properties for sale as individual unit listings: used condos, new houses, used houses and land. suumo.jp's rental (chintai) section, new-build condo (新築マンション / shinchiku) section, and custom-order house (注文住宅 / chumon) section are all organized as project/catalog pages rather than a paginated list of individual unit listings, and require different scraping logic that isn't yet supported.

Why do some listings lack builtYear or layout? Land listings have no building, so builtYear and layout don't apply. New-house listings under construction may also omit these until the build is complete. The actor never invents data — a missing field means suumo.jp didn't publish it for that listing.

How many listings can I get per run? Up to maxItems (default 30, max 2000). suumo.jp paginates at 30 listings per page.