Sign inGet a free API keyDashboard
Menu

APIs / Real estate / LIFULL HOME'S

1 credit per call7 endpoints29 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 keyRun 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 OKJSONX-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_idstringbuilding_namestringbuilding_typestringaddressstringstationsobject[]age_textstringage_yearsintegerfloors_textstringfloors_aboveintegerthumbnailurlidstringsource_urlurlfloorstringrent_textstringrent_yenintegeradmin_fee_textstringadmin_fee_yenintegerdeposit_textstringdeposit_monthsintegerdeposit_yennumberkey_money_textstringkey_money_yennumberlayoutstringarea_textstringarea_m2numberfloor_plan_imageurlfeaturesstring[]catchphrasestringagency_namestring
11107060012387JR総武線 大久保駅 徒歩9分賃貸マンション東京都新宿区北新宿2丁目3-21[3 items]56年566階建6https://image1.homes.jp/smallimg/image.php?file=http%3A%2F%2Fimg.homes.jp%2F110706%2Frent%2F12387%2F2%2F2%2Fga4t.jpgd1a2edc79cdcd1f3273212a7dd3c1114b3697132https://www.homes.co.jp/chintai/room/d1a2edc79cdcd1f3273212a7dd3c1114b3697132/1階12万円12000015,000円15000無0012万円1200001K25.49m²25.49https://image1.homes.jp/smallimg/image.php?file=http%3A%2F%2Fimg.homes.jp%2F110706%2Frent%2F12387%2F1%2F1%2F2kvj.jpg[3 items]2026年5月フルリフォーム！快適で綺麗な住環境！株式会社吉住ホーム 西新宿店
21579720000227ドミール北新宿賃貸マンション東京都新宿区北新宿1丁目6-22[3 items]30年3011階建11https://image2.homes.jp/smallimg/image.php?file=http%3A%2F%2Fimg.homes.jp%2F157972%2Frent%2F227%2F2%2F1%2F5ifo.jpg9f3606e3851c76b7735fbc536d3b07a43a6a85c0https://www.homes.co.jp/chintai/room/9f3606e3851c76b7735fbc536d3b07a43a6a85c0/10階9.2万円9200010,500円105001ヶ月1—1ヶ月—1K20.35m²20.35https://image.homes.jp/smallimg/image.php?file=http%3A%2F%2Fimg.homes.jp%2F157972%2Frent%2F227%2F1%2F2%2Ffepq.jpg[3 items]新宿駅まで徒歩圏内。通勤にも通学にも便利です。株式会社共立メンテナンス ドミール事業部
31579720000227ドミール北新宿賃貸マンション東京都新宿区北新宿1丁目6-22[3 items]30年3011階建11https://image2.homes.jp/smallimg/image.php?file=http%3A%2F%2Fimg.homes.jp%2F157972%2Frent%2F227%2F2%2F1%2F5ifo.jpg17e1cbb7e19e0ac84d217664dc26a5aa9bbe7a31https://www.homes.co.jp/chintai/room/17e1cbb7e19e0ac84d217664dc26a5aa9bbe7a31/10階9.2万円9200010,500円105001ヶ月1—1ヶ月—1K20.35m²20.35https://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 itemGET /v1/lifull-homes/rent-search?prefecture=tokyo&city=shinjuku-city&rent_max=120000

29 datapoints

Identity

  • building_idstring
  • building_namestring
  • building_typestring
  • idstring
  • agency_namestring

Contact

  • source_urlurl

Location

  • addressstring
  • area_textstring
  • area_m2number

Reputation

  • floor_plan_imageurl

Price

  • admin_fee_textstring
  • admin_fee_yeninteger

Other

  • stationsobject[]
  • age_textstring
  • age_yearsinteger
  • floors_textstring
  • floors_aboveinteger
  • thumbnailurl
  • floorstring
  • rent_textstring
  • rent_yeninteger
  • deposit_textstring
  • deposit_monthsinteger
  • deposit_yennumber
  • key_money_textstring
  • key_money_yennumber
  • layoutstring
  • featuresstring[]
  • catchphrasestring

Playground

Run this API

cURLshell
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.

EndpointRequired parametersCost
GET/v1/lifull-homes/agency
id
1 credit
GET/v1/lifull-homes/areas
prefecture+1 optional
1 credit
GET/v1/lifull-homes/autocomplete
query
1 credit
GET/v1/lifull-homes/rent-listing
id
1 credit
GET/v1/lifull-homes/rent-search
prefecture+10 optional
1 credit
GET/v1/lifull-homes/sale-listing
idvertical
1 credit
GET/v1/lifull-homes/sale-search
prefecture+13 optional
1 credit

Overview

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 estateJSONRESTMCP

More real estate APIs

28Hse4zida59199.co99acresAdondevivirApartment ListApartments.comAqarAqarmapArgenpropathome

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 keyRead the docs