Yahoo! Real Estate Japan Rent Scraper (Yahoo!不動産 賃貸)

Scrape rental listings (賃貸マンション・アパート・一戸建て) from Yahoo!不動産, Japan's largest open rental aggregator: it republishes listings from SUUMO, LIFULL HOME'S, athome and hundreds of agents, so one crawl covers the market. Every result is one room with rent, management fee, deposit and key money in yen, layout, floor area in m², floor, building age, nearest stations with walking minutes, address and coordinates, and (with details) direction, contract period, move-in date, listing date, remarks and the listing agent.

Pick cities by JIS code or paste a search URL from the site. No login, no API key, no browser.

Input

Field	Type	Description
areas	array	Cities as "<prefectureCode>/<cityCode>" (JIS codes, e.g. 13/13101 東京都千代田区, 13/13113 渋谷区, 27/27127 大阪市北区) or a full https://realestate.yahoo.co.jp/rent/search/03/<pref>/<city>/ URL copied from the site (max 50). Listings come in the site's default order, newest first.
detailUrls	array	Specific https://realestate.yahoo.co.jp/rent/detail/<id>/ URLs (max 2000).
fetchDetails	boolean	Open each listing page for direction, contract period, move-in, listing date, remarks, facilities and the agent (default true; one extra request per listing). false = list-level fields only, about 30× faster.
maxItems	integer	Stop after this many listings (default 100, max 20000). You pay only for pushed listings.
maxConcurrency	integer	Parallel requests (default 5, max 10). Requests are spaced ~1 s apart, so throughput is about one page per second regardless.
proxyConfiguration	object	Optional proxy settings; normally not needed.

At least one of areas / detailUrls is required. City codes: the site's own URLs carry them (/rent/search/03/13/13113/ → 13/13113); any JIS 市区町村コード table works too.

{
  "areas": ["13/13101", "13/13113"],
  "fetchDetails": true,
  "maxItems": 500
}

Output

One dataset item per room:

{
  "id": "_0000008657270c4b103669fbce7203c08d54d52b48b5",
  "url": "https://realestate.yahoo.co.jp/rent/detail/_0000008657270c4b103669fbce7203c08d54d52b48b5/",
  "area": "13/13101",
  "buildingName": null,
  "buildingLabel": "山手線 神田駅 8階建 築24年",
  "kind": "マンション",
  "prefecture": "東京都",
  "city": "千代田区",
  "cityCode": "13101",
  "address": "東京都千代田区神田多町2",
  "lat": 35.69425271,
  "lng": 139.76928534,
  "rent": 120000,
  "managementFee": 0,
  "keyMoney": 240000,
  "securityDeposit": 0,
  "deposit": 0,
  "cancellationDeduction": 0,
  "layoutCode": 2,
  "layout": "1K",
  "layoutDetail": "1K (洋7.5 K2.0)",
  "areaSqm": 23.44,
  "floor": 8,
  "totalFloors": 8,
  "builtOn": "2002-11",
  "yearsOld": 24,
  "isNewlyBuilt": false,
  "isNewArrival": true,
  "direction": "南東",
  "contractPeriod": "2年",
  "buildCondition": "定期借家",
  "insurance": "あり",
  "moveIn": "相談",
  "listedAt": "2026-10-09",
  "remark": "合計3.3万円(内訳：鍵交換代3.3万円)\n更新料　新賃料1.00ヶ月分\n…",
  "prComment": "【神田駅から徒歩3分】…",
  "facilities": ["015", "018", "023"],
  "features": ["ac", "al", "bd", "ev", "sk"],
  "stations": [
    { "line": "山手線", "station": "神田", "walkMinutes": 4, "label": "神田駅/山手線 徒歩4分" },
    { "line": "東京メトロ丸ノ内線", "station": "淡路町", "walkMinutes": 5, "label": "淡路町駅/東京メトロ丸ノ内線 徒歩5分" }
  ],
  "imageUrl": "https://realestate-pctr.c.yimg.jp/…",
  "layoutImageUrl": "https://realestate-pctr.c.yimg.jp/…",
  "agent": { "name": "REOL(株)新宿駅前店", "transactionType": "仲介", "address": "東京都新宿区西新宿1-15-4…", "license": "東京都知事(1)第108035号 / …", "tel": "03-5909-3670" },
  "detailsFetched": true
}

All money fields are yen per month (rent, management fee) or one-off yen (deposit, key money, security deposit, cancellation deduction); 0 means the site shows なし (none), null means not stated. buildingName is set only when the agent allows the name to be shown; buildingLabel is the site's own label (line, station, floors, age). layout is the standard label (ワンルーム, 1K, 1LDK, 2LDK …); layoutDetail adds the room breakdown when details were fetched. features are the site's amenity codes (al auto-lock, ev elevator, bt bath/toilet separate, ac air conditioning …) and facilities its numeric facility codes.

With fetchDetails: false the record carries the list-level fields only and detailsFetched is false.

Notes

• Listings are taken in the site's default order (newest first). Sorted or map-bounded searches are not offered: the site's robots.txt excludes those URL forms, and this actor honours it.
• maxItems counts rooms, not buildings; a building with several vacant rooms yields several records.
• A wrong city code answers 404 and is reported in the run's status message; other areas in the same run continue.
• An item is pushed and charged exactly once; re-running a migrated or resumed run never double-charges.
• Only rentals (賃貸) are covered. Sale listings (中古マンション, 新築 etc.) are a different vertical with different URL rules.

Speed, cost and timeouts

Requests are paced at about one per second to stay within the site's comfort zone. With fetchDetails: true that is roughly 50 listings per minute (one list page per 56 rooms plus one page per room); with fetchDetails: false about 3,000 listings per minute. The default run (one city, 100 listings with details) finishes in about 2 minutes. For a whole prefecture, raise the run timeout or split the cities across runs; the run stops cleanly at maxItems or at your budget limit and everything pushed up to that point is kept.

Use cases

• Rent indices and market analytics for Tokyo 23 wards, Osaka, Nagoya, Fukuoka: price per m² by layout, age and station distance.
• Relocation and foreign-tenant agencies: fresh inventory by city with fees broken out (deposit, key money, management fee).
• Investors tracking asking rents for specific buildings or areas over time.
• Proptech and data teams needing a structured feed of Japanese rental listings without building scrapers for each portal.