--- title: "LIFULL HOME'S API: JSON data, 7 endpoints, 1 credit per call" description: "LIFULL HOME'S API for Japanese rentals, condos, houses and land for sale, listing details, agencies and areas as JSON. 1 credit per successful call." url: https://perceptlayer.com/apis/lifull-homes --- [APIs](https://perceptlayer.com/apis) / [Real estate](https://perceptlayer.com/verticals/real-estate) / LIFULL HOME'S 1 credit per call 7 endpoints 29 datapoints # LIFULL HOME'S API LIFULL HOME'S API for Japanese rentals, condos, houses and land for sale, listing details, agencies and areas as JSON. 1 credit per successful call. [Get a free API key](https://perceptlayer.com/signup) Run it below LIFULL HOME'S GET /v1/lifull-homes/rent-search?prefecture=tokyo&city=shinjuku-city&rent\_max=120000 ``` { "success": true, "data": { "pagination": { "page": 1, "has_next_page": true, "last_page": 54, "total_results": 2900, "buildings_on_page": 30 }, "total_rooms": 11281, "filters": { "prefecture": "tokyo", "city": "shinjuku-city", "rent_max": 120000 }, "listings": [ { "building_id": "1107060012387", "building_name": "JR総武線 大久保駅 徒歩9分", "building_type": "賃貸マンション", "address": "東京都新宿区北新宿2丁目3-21", "stations": [ { "line": "JR山手線", "station": "新宿", "walk_min": 20, "raw": "JR山手線 新宿駅 徒歩20分" }, { "line": "JR総武線", "station": "大久保", "walk_min": 9, "raw": "JR総武線 大久保駅 徒歩9分" }, { "line": "東京メトロ丸ノ内線", "station": "西新宿", "walk_min": 9, "raw": "東京メトロ丸ノ内線 西新宿駅 徒歩9分" } ], "age_text": "56年", "age_years": 56, "floors_text": "6階建", "floors_above": 6, "thumbnail": "https://image1.homes.jp/smallimg/image.php?file=http%3A%2F%2Fimg.homes.jp%2F110706%2Frent%2F12387%2F2%2F2%2Fga4t.jpg", "id": "d1a2edc79cdcd1f3273212a7dd3c1114b3697132", "source_url": "https://www.homes.co.jp/chintai/room/d1a2edc79cdcd1f3273212a7dd3c1114b3697132/", "floor": "1階", "rent_text": "12万円", "rent_yen": 120000, "admin_fee_text": "15,000円", "admin_fee_yen": 15000, "deposit_text": "無", "deposit_months": 0, "deposit_yen": 0, "key_money_text": "12万円", "key_money_yen": 120000, "layout": "1K", "area_text": "25.49m²", "area_m2": 25.49, "floor_plan_image": "https://image1.homes.jp/smallimg/image.php?file=http%3A%2F%2Fimg.homes.jp%2F110706%2Frent%2F12387%2F1%2F1%2F2kvj.jpg", "features": [ "浴室乾燥機", "オートロック", "エアコン" ], "catchphrase": "2026年5月フルリフォーム！快適で綺麗な住環境！", "agency_name": "株式会社吉住ホーム 西新宿店" }, { "building_id": "1579720000227", "building_name": "ドミール北新宿", "building_type": "賃貸マンション", "address": "東京都新宿区北新宿1丁目6-22", "stations": [ { "line": "JR山手線", "station": "新宿", "walk_min": 16, "raw": "JR山手線 新宿駅 徒歩16分" }, { "line": "JR総武線", "station": "大久保", "walk_min": 4, "raw": "JR総武線 大久保駅 徒歩4分" }, { "line": "JR山手線", "station": "新大久保", "walk_min": 8, "raw": "JR山手線 新大久保駅 徒歩8分" } ], "age_text": "30年", "age_years": 30, "floors_text": "11階建", "floors_above": 11, "thumbnail": "https://image2.homes.jp/smallimg/image.php?file=http%3A%2F%2Fimg.homes.jp%2F157972%2Frent%2F227%2F2%2F1%2F5ifo.jpg", "id": "9f3606e3851c76b7735fbc536d3b07a43a6a85c0", "source_url": "https://www.homes.co.jp/chintai/room/9f3606e3851c76b7735fbc536d3b07a43a6a85c0/", "floor": "10階", "room_number": "1002", "rent_text": "9.2万円", "rent_yen": 92000, "admin_fee_text": "10,500円", "admin_fee_yen": 10500, "deposit_text": "1ヶ月", "deposit_months": 1, "key_money_text": "1ヶ月", "key_money_months": 1, "layout": "1K", "area_text": "20.35m²", "area_m2": 20.35, "floor_plan_image": "https://image.homes.jp/smallimg/image.php?file=http%3A%2F%2Fimg.homes.jp%2F157972%2Frent%2F227%2F1%2F2%2Ffepq.jpg", "features": [ "フローリング", "オートロック", "エアコン" ], "catchphrase": "新宿駅まで徒歩圏内。通勤にも通学にも便利です。", "agency_name": "株式会社共立メンテナンス ドミール事業部" }, { "building_id": "1579720000227", "building_name": "ドミール北新宿", "building_type": "賃貸マンション", "address": "東京都新宿区北新宿1丁目6-22", "stations": [ { "line": "JR山手線", "station": "新宿", "walk_min": 16, "raw": "JR山手線 新宿駅 徒歩16分" }, { "line": "JR総武線", "station": "大久保", "walk_min": 4, "raw": "JR総武線 大久保駅 徒歩4分" }, { "line": "JR山手線", "station": "新大久保", "walk_min": 8, "raw": "JR山手線 新大久保駅 徒歩8分" } ], "age_text": "30年", "age_years": 30, "floors_text": "11階建", "floors_above": 11, "thumbnail": "https://image2.homes.jp/smallimg/image.php?file=http%3A%2F%2Fimg.homes.jp%2F157972%2Frent%2F227%2F2%2F1%2F5ifo.jpg", "id": "17e1cbb7e19e0ac84d217664dc26a5aa9bbe7a31", "source_url": "https://www.homes.co.jp/chintai/room/17e1cbb7e19e0ac84d217664dc26a5aa9bbe7a31/", "floor": "10階", "rent_text": "9.2万円", "rent_yen": 92000, "admin_fee_text": "10,500円", "admin_fee_yen": 10500, "deposit_text": "1ヶ月", "deposit_months": 1, "key_money_text": "1ヶ月", "key_money_months": 1, "layout": "1K", "area_text": "20.35m²", "area_m2": 20.35, "floor_plan_image": "https://image.homes.jp/smallimg/image.php?file=http%3A%2F%2Fimg.homes.jp%2F147373%2Frent%2F145639%2F1%2F1%2F1rkx.jpg", "features": [ "フローリング", "オートロック", "エアコン" ], "catchphrase": "タウンハウジング新大久保店でご予約受付中！", "agency_name": "株式会社タウンハウジング東京 タウンハウジング 新大久保店" } ] }, "meta": { "endpoint_family": "rent_search", "request_id": "req_4773cf782db14eeabaf3a99b8728c771", "credits_charged": 1, "credits_remaining": 1848 } } ``` 200 OK JSON X-Credits-Used: 1 Recorded from our API and shortened. Sample data ## What one call returns A recorded run of `rent-search`: the fields and shapes you will get, shortened to 3 items. | # | building\_id string | building\_name string | building\_type string | address string | stations object\[\] | age\_text string | age\_years integer | floors\_text string | floors\_above integer | thumbnail url | id string | source\_url url | floor string | rent\_text string | rent\_yen integer | admin\_fee\_text string | admin\_fee\_yen integer | deposit\_text string | deposit\_months integer | deposit\_yen number | key\_money\_text string | key\_money\_yen number | layout string | area\_text string | area\_m2 number | floor\_plan\_image url | features string\[\] | catchphrase string | agency\_name string | | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | 1 | 1107060012387 | JR総武線 大久保駅 徒歩9分 | 賃貸マンション | 東京都新宿区北新宿2丁目3-21 | \[3 items\] | 56年 | 56 | 6階建 | 6 | https://image1.homes.jp/smallimg/image.php?file=http%3A%2F%2Fimg.homes.jp%2F110706%2Frent%2F12387%2F2%2F2%2Fga4t.jpg | d1a2edc79cdcd1f3273212a7dd3c1114b3697132 | https://www.homes.co.jp/chintai/room/d1a2edc79cdcd1f3273212a7dd3c1114b3697132/ | 1階 | 12万円 | 120000 | 15,000円 | 15000 | 無 | 0 | 0 | 12万円 | 120000 | 1K | 25.49m² | 25.49 | https://image1.homes.jp/smallimg/image.php?file=http%3A%2F%2Fimg.homes.jp%2F110706%2Frent%2F12387%2F1%2F1%2F2kvj.jpg | \[3 items\] | 2026年5月フルリフォーム！快適で綺麗な住環境！ | 株式会社吉住ホーム 西新宿店 | | 2 | 1579720000227 | ドミール北新宿 | 賃貸マンション | 東京都新宿区北新宿1丁目6-22 | \[3 items\] | 30年 | 30 | 11階建 | 11 | https://image2.homes.jp/smallimg/image.php?file=http%3A%2F%2Fimg.homes.jp%2F157972%2Frent%2F227%2F2%2F1%2F5ifo.jpg | 9f3606e3851c76b7735fbc536d3b07a43a6a85c0 | https://www.homes.co.jp/chintai/room/9f3606e3851c76b7735fbc536d3b07a43a6a85c0/ | 10階 | 9.2万円 | 92000 | 10,500円 | 10500 | 1ヶ月 | 1 | — | 1ヶ月 | — | 1K | 20.35m² | 20.35 | https://image.homes.jp/smallimg/image.php?file=http%3A%2F%2Fimg.homes.jp%2F157972%2Frent%2F227%2F1%2F2%2Ffepq.jpg | \[3 items\] | 新宿駅まで徒歩圏内。通勤にも通学にも便利です。 | 株式会社共立メンテナンス ドミール事業部 | | 3 | 1579720000227 | ドミール北新宿 | 賃貸マンション | 東京都新宿区北新宿1丁目6-22 | \[3 items\] | 30年 | 30 | 11階建 | 11 | https://image2.homes.jp/smallimg/image.php?file=http%3A%2F%2Fimg.homes.jp%2F157972%2Frent%2F227%2F2%2F1%2F5ifo.jpg | 17e1cbb7e19e0ac84d217664dc26a5aa9bbe7a31 | https://www.homes.co.jp/chintai/room/17e1cbb7e19e0ac84d217664dc26a5aa9bbe7a31/ | 10階 | 9.2万円 | 92000 | 10,500円 | 10500 | 1ヶ月 | 1 | — | 1ヶ月 | — | 1K | 20.35m² | 20.35 | https://image.homes.jp/smallimg/image.php?file=http%3A%2F%2Fimg.homes.jp%2F147373%2Frent%2F145639%2F1%2F1%2F1rkx.jpg | \[3 items\] | タウンハウジング新大久保店でご予約受付中！ | 株式会社タウンハウジング東京 タウンハウジング 新大久保店 | Recorded from our API · 3 items shown · 29 datapoints per item GET /v1/lifull-homes/rent-search?prefecture=tokyo&city=shinjuku-city&rent\_max=120000 29 datapoints ### Identity - building\_id string - building\_name string - building\_type string - id string - agency\_name string ### Contact - source\_url url ### Location - address string - area\_text string - area\_m2 number ### Reputation - floor\_plan\_image url ### Price - admin\_fee\_text string - admin\_fee\_yen integer ### Other - stations object\[\] - age\_text string - age\_years integer - floors\_text string - floors\_above integer - thumbnail url - floor string - rent\_text string - rent\_yen integer - deposit\_text string - deposit\_months integer - deposit\_yen number - key\_money\_text string - key\_money\_yen number - layout string - features string\[\] - catchphrase string Playground ## Run this API cURL shell ``` curl "https://api.perceptlayer.com/v1/lifull-homes/rent-search?prefecture=tokyo&city=shinjuku-city&rent_max=120000" \ -H "X-API-Key: $API_KEY" ``` LIFULL HOME'S · 7 endpoints ## Endpoints Every endpoint takes the same key. Open one for its parameters and an example request. | Endpoint | Required parameters | Cost | | --- | --- | --- | | [GET `/v1/lifull-homes/agency`](https://perceptlayer.com/apis/lifull-homes/agency) | `id` | 1 credit | | [GET `/v1/lifull-homes/areas`](https://perceptlayer.com/apis/lifull-homes/areas) | `prefecture` +1 optional | 1 credit | | [GET `/v1/lifull-homes/autocomplete`](https://perceptlayer.com/apis/lifull-homes/autocomplete) | `query` | 1 credit | | [GET `/v1/lifull-homes/rent-listing`](https://perceptlayer.com/apis/lifull-homes/rent-listing) | `id` | 1 credit | | [GET `/v1/lifull-homes/rent-search`](https://perceptlayer.com/apis/lifull-homes/rent-search) | `prefecture` +10 optional | 1 credit | | [GET `/v1/lifull-homes/sale-listing`](https://perceptlayer.com/apis/lifull-homes/sale-listing) | `id` `vertical` | 1 credit | | [GET `/v1/lifull-homes/sale-search`](https://perceptlayer.com/apis/lifull-homes/sale-search) | `prefecture` +13 optional | 1 credit | Overview ## About the LIFULL HOME'S API ## What you can get The LIFULL HOME'S API returns LIFULL HOME'S property data as JSON through 7 endpoints. The search endpoints and `areas` take a `prefecture`, one of Japan's 47 (hokkaido, tokyo, kanagawa, osaka, kyoto, fukuoka, okinawa and the rest). - **Rentals:** `rent-search` takes a `prefecture`, with `city`, `rent_min`, `rent_max`, `area_min`, `area_max`, `walk_max` (1, 5, 7, 10, 15 or 20 minutes), `age_max`, `layouts`, `sort` (recommended, price\_asc, price\_desc, area\_desc, built\_newest, address or newest) and `page`; `rent-listing` takes an `id`. - **For sale:** `sale-search` takes a `prefecture`, with `property_type` (used\_mansion, new\_mansion, used\_house, new\_house or land), `city`, `price_min`, `price_max`, `area_min`, `area_max`, `land_area_min`, `land_area_max`, `walk_max`, `age_max`, `layouts`, `sort` and `page`; `sale-listing` takes an `id` and a `vertical` (mansion, kodate or tochi). - **Agencies:** `agency` takes an `id`. - **Locations:** `areas` takes a `prefecture`, with `query`; `autocomplete` takes a `query`. The recorded `rent-search` for `shinjuku-city` in Tokyo (rent up to 120,000) returns `listings` grouped by building, each with `building_id`, `building_name`, `building_type`, `address`, `stations`, `age_years`, `floors_above`, `id`, `floor`, `rent_yen`, `admin_fee_yen`, `deposit_yen`, `key_money_yen`, `layout`, `area_m2`, `floor_plan_image`, `features` and `agency_name`. It also returns `total_rooms` and `pagination` with `last_page`, `buildings_on_page` and `has_next_page`. ## How a call works Search a city: `GET /v1/lifull-homes/rent-search?prefecture=tokyo&city=shinjuku-city&rent_max=120000` with your key in the `X-API-Key` header. Each room's `id` is what `rent-listing` takes. Every successful call costs 1 credit; failed calls cost nothing. Real estate JSON REST MCP ### More real estate APIs [28Hse](https://perceptlayer.com/apis/28hse) [4zida](https://perceptlayer.com/apis/4zida) [591](https://perceptlayer.com/apis/591-house) [99.co](https://perceptlayer.com/apis/99co) [99acres](https://perceptlayer.com/apis/99acres) [Adondevivir](https://perceptlayer.com/apis/adondevivir) [Apartment List](https://perceptlayer.com/apis/apartment-list) [Apartments.com](https://perceptlayer.com/apis/apartments-com) [Aqar](https://perceptlayer.com/apis/aqar) [Aqarmap](https://perceptlayer.com/apis/aqarmap) [Argenprop](https://perceptlayer.com/apis/argenprop) [athome](https://perceptlayer.com/apis/athome) Use cases ### Track rents in Tokyo wards and other Japanese cities, with admin fee, deposit and key money `Use the LIFULL HOME'S API to track rents in Tokyo wards and other Japanese cities, with admin fee, deposit and key money` ### Compare upfront costs from \`deposit\_yen\` and \`key\_money\_yen\` `` Use the LIFULL HOME'S API to compare upfront costs from `deposit_yen` and `key_money_yen` `` ### Find rooms within a set walk of a station with \`walk\_max\` `` Use the LIFULL HOME'S API to find rooms within a set walk of a station with `walk_max` `` ### Track asking prices for used and new condos (mansion) and houses `Use the LIFULL HOME'S API to track asking prices for used and new condos (mansion) and houses` FAQ ## Questions **How much does the LIFULL HOME'S API cost?** Each successful call costs one credit. New accounts get free credits to start, and credit packs bring the price down as you scale. **What format are responses in?** Every endpoint returns JSON, with no HTML parsing on your side. **Do I need a LIFULL HOME'S account?** No. You call this LIFULL HOME'S API with your Perceptlayer key in the \`X-API-Key\` header, with no LIFULL HOME'S login. **Does it cover homes for sale?** Yes. \`sale-search\` takes a \`property\_type\` of used\_mansion, new\_mansion, used\_house, new\_house or land, and \`sale-listing\` takes an \`id\` with a \`vertical\` of mansion, kodate or tochi. **Should I build a LIFULL HOME'S scraper instead?** You can, but a LIFULL HOME'S scraper is code you maintain: page changes break it, requests get blocked, and LIFULL HOME'S's terms govern how you collect data. The LIFULL HOME'S API gives you 7 endpoints of named JSON fields for 1 credit per successful call, and failed calls cost nothing. A scraper makes sense only for data these endpoints don't return, so check the response in the playground on this page first. ## Try the LIFULL HOME'S API with 100 free credits No credit card. Failed calls are never billed. [Get a free API key](https://perceptlayer.com/signup) [Read the docs](https://docs.perceptlayer.com)