1 credit per call6 endpoints26 datapoints

591 API

591 API for Taiwan rentals and homes for sale: rent and sale search, listing details and district lookups as JSON. 1 credit per successful call.

Get a free API key Run it below

591

GET/v1/591-house/rent-search?region_id=1&section_ids[]=5&kind=2&price_min=10000&price_max=20000&sort=price_asc

{
  "success": true,
  "data": {
    "items": [
      {
        "id": 22302156,
        "url": "https://rent.591.com.tw/22302156",
        "title": "捷運麟光站【秒殺租案】變頻冷氣/格局方正/採光優/乾溼分離",
        "kind": 2,
        "kind_name": "獨立套房",
        "price_value": 10000,
        "price_text": "10,000 元/月",
        "price_unit": "元/月",
        "area_ping": 7,
        "floor_text": "頂樓加蓋/5F",
        "total_floors": 5,
        "fitment": "簡易裝潢",
        "address": "大安區-富陽街157巷",
        "district": "大安區",
        "street": "富陽街157巷",
        "region_id": 1,
        "section_id": 5,
        "tags": [
          "近捷運",
          "新上架",
          "拎包入住"
        ],
        "transit": {
          "type": "metro",
          "station": "麟光站",
          "distance_m": 131
        },
        "photos": [
          "https://img1.591.com.tw/house/2026/11/06/179394208377577804.jpg!510x400.jpg",
          "https://img1.591.com.tw/house/2026/11/06/179394208376029300.jpg!510x400.jpg",
          "https://img2.591.com.tw/house/2026/11/06/179394208375261402.jpg!510x400.jpg"
        ],
        "has_video": false,
        "refreshed_text": "10小時內更新",
        "refreshed_at": "2026-11-12T03:26:32+00:00",
        "views": 47,
        "owner_type": "agent",
        "price_includes": "(租金含水費/網路/第四臺等)"
      },
      {
        "id": 22315068,
        "url": "https://rent.591.com.tw/22315068",
        "title": "🌿【大安區特色好宅】遠離喧囂、親近自然｜還能欣賞101夜景",
        "kind": 2,
        "kind_name": "獨立套房",
        "price_value": 10000,
        "price_text": "10,000 元/月",
        "price_unit": "元/月",
        "area_ping": 12,
        "floor_text": "1F/1F",
        "floor": 1,
        "total_floors": 1,
        "fitment": "--",
        "address": "大安區-和平東路三段",
        "district": "大安區",
        "street": "和平東路三段",
        "region_id": 1,
        "section_id": 5,
        "tags": [
          "近捷運",
          "新上架",
          "拎包入住"
        ],
        "transit": {
          "type": "metro",
          "station": "麟光站",
          "distance_m": 29
        },
        "photos": [
          "https://img1.591.com.tw/house/2026/10/22/179265868813941304.jpg!510x400.jpg",
          "https://img1.591.com.tw/house/2026/10/22/179265868819084301.jpg!510x400.jpg",
          "https://img2.591.com.tw/house/2026/10/22/179265868813950302.jpg!510x400.jpg"
        ],
        "has_video": false,
        "refreshed_text": "6小時內更新",
        "refreshed_at": "2026-11-12T07:26:32+00:00",
        "views": 62,
        "owner_type": "agent"
      },
      {
        "id": 22335416,
        "url": "https://rent.591.com.tw/22335416",
        "title": "信義安和商圈，生活機能超方便！",
        "kind": 2,
        "kind_name": "獨立套房",
        "price_value": 10000,
        "price_text": "10,000 元/月",
        "price_unit": "元/月",
        "area_ping": 8.4,
        "floor_text": "4F/4F",
        "floor": 4,
        "total_floors": 4,
        "fitment": "簡易裝潢",
        "address": "大安區-通化街26號",
        "district": "大安區",
        "street": "通化街26號",
        "region_id": 1,
        "section_id": 5,
        "tags": [
          "屋主直租",
          "近捷運",
          "新上架"
        ],
        "transit": {
          "type": "metro",
          "station": "信義安和",
          "distance_m": 188
        },
        "photos": [
          "https://img1.591.com.tw/house/2017/10/11/150772878406440404.jpg!510x400.jpg",
          "https://img2.591.com.tw/house/2023/06/30/168809606000706407.jpg!510x400.jpg",
          "https://img2.591.com.tw/house/2023/06/30/168809605974483907.jpg!510x400.jpg"
        ],
        "has_video": false,
        "refreshed_text": "11小時內更新",
        "refreshed_at": "2026-11-12T02:26:32+00:00",
        "views": 0,
        "owner_type": "owner",
        "price_includes": "(租金含網路)"
      }
    ],
    "pagination": {
      "current_page": 1,
      "page_size": 30,
      "total": 220,
      "total_pages": 8,
      "has_next": true
    },
    "filters_applied": {
      "region_id": "1",
      "kind": "2",
      "price_min": "10000",
      "price_max": "20000",
      "sort": "price_asc",
      "section_ids": [
        "5"
      ]
    }
  },
  "meta": {
    "endpoint_family": "rent_search",
    "request_id": "req_f57a2608904a470d83e338e5bb427aa0",
    "credits_charged": 1,
    "credits_remaining": 1898
  }
}

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.

#	idinteger	urlurl	titlestring	kindinteger	kind_namestring	price_valueinteger	price_textstring	price_unitstring	area_pingnumber	floor_textstring	total_floorsinteger	fitmentstring	addressstring	districtstring	streetstring	region_idinteger	section_idinteger	tagsstring[]	transitobject	photosstring[]	has_videoboolean	refreshed_textstring	refreshed_atstring	viewsinteger	owner_typestring	price_includesstring
1	22302156	https://rent.591.com.tw/22302156	捷運麟光站【秒殺租案】變頻冷氣/格局方正/採光優/乾溼分離	2	獨立套房	10000	10,000 元/月	元/月	7	頂樓加蓋/5F	5	簡易裝潢	大安區-富陽街157巷	大安區	富陽街157巷	1	5	[3 items]	{3 fields}	[3 items]	false	10小時內更新	2026-11-12T03:26:32+00:00	47	agent	(租金含水費/網路/第四臺等)
2	22315068	https://rent.591.com.tw/22315068	🌿【大安區特色好宅】遠離喧囂、親近自然｜還能欣賞101夜景	2	獨立套房	10000	10,000 元/月	元/月	12	1F/1F	1	--	大安區-和平東路三段	大安區	和平東路三段	1	5	[3 items]	{3 fields}	[3 items]	false	6小時內更新	2026-11-12T07:26:32+00:00	62	agent	—
3	22335416	https://rent.591.com.tw/22335416	信義安和商圈，生活機能超方便！	2	獨立套房	10000	10,000 元/月	元/月	8.4	4F/4F	4	簡易裝潢	大安區-通化街26號	大安區	通化街26號	1	5	[3 items]	{3 fields}	[3 items]	false	11小時內更新	2026-11-12T02:26:32+00:00	0	owner	(租金含網路)

[
  {
    "id": 22302156,
    "url": "https://rent.591.com.tw/22302156",
    "title": "捷運麟光站【秒殺租案】變頻冷氣/格局方正/採光優/乾溼分離",
    "kind": 2,
    "kind_name": "獨立套房",
    "price_value": 10000,
    "price_text": "10,000 元/月",
    "price_unit": "元/月",
    "area_ping": 7,
    "floor_text": "頂樓加蓋/5F",
    "total_floors": 5,
    "fitment": "簡易裝潢",
    "address": "大安區-富陽街157巷",
    "district": "大安區",
    "street": "富陽街157巷",
    "region_id": 1,
    "section_id": 5,
    "tags": [
      "近捷運",
      "新上架",
      "拎包入住"
    ],
    "transit": {
      "type": "metro",
      "station": "麟光站",
      "distance_m": 131
    },
    "photos": [
      "https://img1.591.com.tw/house/2026/11/06/179394208377577804.jpg!510x400.jpg",
      "https://img1.591.com.tw/house/2026/11/06/179394208376029300.jpg!510x400.jpg",
      "https://img2.591.com.tw/house/2026/11/06/179394208375261402.jpg!510x400.jpg"
    ],
    "has_video": false,
    "refreshed_text": "10小時內更新",
    "refreshed_at": "2026-11-12T03:26:32+00:00",
    "views": 47,
    "owner_type": "agent",
    "price_includes": "(租金含水費/網路/第四臺等)"
  },
  {
    "id": 22315068,
    "url": "https://rent.591.com.tw/22315068",
    "title": "🌿【大安區特色好宅】遠離喧囂、親近自然｜還能欣賞101夜景",
    "kind": 2,
    "kind_name": "獨立套房",
    "price_value": 10000,
    "price_text": "10,000 元/月",
    "price_unit": "元/月",
    "area_ping": 12,
    "floor_text": "1F/1F",
    "floor": 1,
    "total_floors": 1,
    "fitment": "--",
    "address": "大安區-和平東路三段",
    "district": "大安區",
    "street": "和平東路三段",
    "region_id": 1,
    "section_id": 5,
    "tags": [
      "近捷運",
      "新上架",
      "拎包入住"
    ],
    "transit": {
      "type": "metro",
      "station": "麟光站",
      "distance_m": 29
    },
    "photos": [
      "https://img1.591.com.tw/house/2026/10/22/179265868813941304.jpg!510x400.jpg",
      "https://img1.591.com.tw/house/2026/10/22/179265868819084301.jpg!510x400.jpg",
      "https://img2.591.com.tw/house/2026/10/22/179265868813950302.jpg!510x400.jpg"
    ],
    "has_video": false,
    "refreshed_text": "6小時內更新",
    "refreshed_at": "2026-11-12T07:26:32+00:00",
    "views": 62,
    "owner_type": "agent"
  },
  {
    "id": 22335416,
    "url": "https://rent.591.com.tw/22335416",
    "title": "信義安和商圈，生活機能超方便！",
    "kind": 2,
    "kind_name": "獨立套房",
    "price_value": 10000,
    "price_text": "10,000 元/月",
    "price_unit": "元/月",
    "area_ping": 8.4,
    "floor_text": "4F/4F",
    "floor": 4,
    "total_floors": 4,
    "fitment": "簡易裝潢",
    "address": "大安區-通化街26號",
    "district": "大安區",
    "street": "通化街26號",
    "region_id": 1,
    "section_id": 5,
    "tags": [
      "屋主直租",
      "近捷運",
      "新上架"
    ],
    "transit": {
      "type": "metro",
      "station": "信義安和",
      "distance_m": 188
    },
    "photos": [
      "https://img1.591.com.tw/house/2017/10/11/150772878406440404.jpg!510x400.jpg",
      "https://img2.591.com.tw/house/2023/06/30/168809606000706407.jpg!510x400.jpg",
      "https://img2.591.com.tw/house/2023/06/30/168809605974483907.jpg!510x400.jpg"
    ],
    "has_video": false,
    "refreshed_text": "11小時內更新",
    "refreshed_at": "2026-11-12T02:26:32+00:00",
    "views": 0,
    "owner_type": "owner",
    "price_includes": "(租金含網路)"
  }
]

id,url,title,kind,kind_name,price_value,price_text,price_unit,area_ping,floor_text,total_floors,fitment,address,district,street,region_id,section_id,tags,transit,photos,has_video,refreshed_text,refreshed_at,views,owner_type,price_includes
22302156,https://rent.591.com.tw/22302156,捷運麟光站【秒殺租案】變頻冷氣/格局方正/採光優/乾溼分離,2,獨立套房,10000,"10,000 元/月",元/月,7,頂樓加蓋/5F,5,簡易裝潢,大安區-富陽街157巷,大安區,富陽街157巷,1,5,"[""近捷運"",""新上架"",""拎包入住""]","{""type"":""metro"",""station"":""麟光站"",""distance_m"":131}","[""https://img1.591.com.tw/house/2026/11/06/179394208377577804.jpg!510x400.jpg"",""https://img1.591.com.tw/house/2026/11/06/179394208376029300.jpg!510x400.jpg"",""https://img2.591.com.tw/house/2026/11/06/179394208375261402.jpg!510x400.jpg""]",false,10小時內更新,2026-11-12T03:26:32+00:00,47,agent,(租金含水費/網路/第四臺等)
22315068,https://rent.591.com.tw/22315068,🌿【大安區特色好宅】遠離喧囂、親近自然｜還能欣賞101夜景,2,獨立套房,10000,"10,000 元/月",元/月,12,1F/1F,1,--,大安區-和平東路三段,大安區,和平東路三段,1,5,"[""近捷運"",""新上架"",""拎包入住""]","{""type"":""metro"",""station"":""麟光站"",""distance_m"":29}","[""https://img1.591.com.tw/house/2026/10/22/179265868813941304.jpg!510x400.jpg"",""https://img1.591.com.tw/house/2026/10/22/179265868819084301.jpg!510x400.jpg"",""https://img2.591.com.tw/house/2026/10/22/179265868813950302.jpg!510x400.jpg""]",false,6小時內更新,2026-11-12T07:26:32+00:00,62,agent,
22335416,https://rent.591.com.tw/22335416,信義安和商圈，生活機能超方便！,2,獨立套房,10000,"10,000 元/月",元/月,8.4,4F/4F,4,簡易裝潢,大安區-通化街26號,大安區,通化街26號,1,5,"[""屋主直租"",""近捷運"",""新上架""]","{""type"":""metro"",""station"":""信義安和"",""distance_m"":188}","[""https://img1.591.com.tw/house/2017/10/11/150772878406440404.jpg!510x400.jpg"",""https://img2.591.com.tw/house/2023/06/30/168809606000706407.jpg!510x400.jpg"",""https://img2.591.com.tw/house/2023/06/30/168809605974483907.jpg!510x400.jpg""]",false,11小時內更新,2026-11-12T02:26:32+00:00,0,owner,(租金含網路)

Recorded from our API · 3 items shown · 26 datapoints per itemGET /v1/591-house/rent-search?region_id=1&section_ids[]=5&kind=2&price_min=10000&price_max=20000&sort=price_asc

26 datapoints

Identity

idinteger
titlestring
kind_namestring
section_idinteger

Contact

urlurl
owner_typestring

Location

area_pingnumber
addressstring
districtstring
streetstring
region_idinteger

Reputation

photosstring[]

Price

price_valueinteger
price_textstring
price_unitstring
price_includesstring

Other

kindinteger
floor_textstring
total_floorsinteger
fitmentstring
tagsstring[]
transitobject
has_videoboolean
refreshed_textstring
refreshed_atstring
viewsinteger

Playground

Run this API

cURLshell

curl "https://api.perceptlayer.com/v1/591-house/rent-search?region_id=1&section_ids[]=5&kind=2&price_min=10000&price_max=20000&sort=price_asc" \
  -H "X-API-Key: $API_KEY"

591 · 6 endpoints

Endpoints

Every endpoint takes the same key. Open one for its parameters and an example request.

Endpoint	Required parameters	Cost
GET`/v1/591-house/locations`	none+2 optional	1 credit
GET`/v1/591-house/locations-suggest`	`qregion_id`	1 credit
GET`/v1/591-house/rent-listing`	`id`	1 credit
GET`/v1/591-house/rent-search`	`region_id`+11 optional	1 credit
GET`/v1/591-house/sale-listing`	`id`	1 credit
GET`/v1/591-house/sale-search`	`region_id`+13 optional	1 credit

Overview

What you can get

The 591 API returns 591 housing data for Taiwan as JSON through 6 endpoints. Searches and location lookups take a numeric region_id (1 to 26).

Rent search: rent-search takes a region_id, with repeatable section_ids[], kind (1, 2, 3, 4 or 8), price_min, price_max, area_min, area_max, keywords, repeatable shape[] and layout[], sort (price_asc, price_desc or newest) and page.
Sale search: sale-search takes a region_id, with repeatable section_ids[], kind (5 to 12), price_min, price_max, area_min, area_max, repeatable shape[] and layout[], bathrooms (1, 2, 3 or 4), age_max, keywords, sort (price_asc, unit_price_asc, newest or area_asc) and cursor.
Listings: rent-listing takes a numeric id; sale-listing takes an id such as S21096373.
Locations: locations takes an optional region_id and q; locations-suggest takes q and a region_id.

The recorded rent-search (region_id=1, section_ids[]=5, kind=2, price_min=10000, price_max=20000, sort=price_asc) returns items, each with id, url, title, kind_name, price_value, price_text, area_ping, floor_text, total_floors, fitment, address, district, street, section_id, tags, transit, photos, views, owner_type and refreshed_at. It also returns pagination with total (220), page_size, total_pages and has_next, and the filters_applied.

How a call works

Search rentals in Taipei's Da'an district: GET /v1/591-house/rent-search?region_id=1&section_ids[]=5&kind=2&price_min=10000&price_max=20000&sort=price_asc with your key in the X-API-Key header. Page with page while has_next is true. Each item's id goes to rent-listing. Find region_id and section_ids[] values with locations or locations-suggest. Every successful call costs 1 credit; failed calls cost nothing.

Real estateJSONRESTMCP

More real estate APIs

Use cases

Track monthly rents by district in Taipei and other Taiwanese cities

Use the 591 API to track monthly rents by district in Taipei and other Taiwanese cities

Compare rent per ping across sections of a city

Use the 591 API to compare rent per ping across sections of a city

Watch new rental listings near a metro station with `sort=newest`

Use the 591 API to watch new rental listings near a metro station with `sort=newest`

Screen homes for sale by `age_max`, `bathrooms` and unit price

Use the 591 API to screen homes for sale by `age_max`, `bathrooms` and unit price

FAQ

Questions

Do I need a 591 account?

No. You call this 591 API with your Perceptlayer key in the `X-API-Key` header, with no 591 login.

How much does the 591 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.

How do rent and sale searches page?

`rent-search` takes a `page`; `sale-search` takes a `cursor` instead.

Should I build a 591 scraper instead?

You can, but a 591 scraper is code you maintain: page changes break it, requests get blocked, and 591's terms govern how you collect data. The 591 API gives you 6 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 591 API with 100 free credits

No credit card. Failed calls are never billed.

Get a free API key Read the docs