--- title: "591 API: JSON data, 6 endpoints, 1 credit per call" description: "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." url: https://perceptlayer.com/apis/591-house --- [APIs](https://perceptlayer.com/apis) / [Real estate](https://perceptlayer.com/verticals/real-estate) / 591 1 credit per call 6 endpoints 26 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](https://perceptlayer.com/signup) Run it below 591 GET /v1/591-house/rent-search?region\_id=1§ion\_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 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. | # | id integer | url url | title string | kind integer | kind\_name string | price\_value integer | price\_text string | price\_unit string | area\_ping number | floor\_text string | total\_floors integer | fitment string | address string | district string | street string | region\_id integer | section\_id integer | tags string\[\] | transit object | photos string\[\] | has\_video boolean | refreshed\_text string | refreshed\_at string | views integer | owner\_type string | price\_includes string | | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | 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 | (租金含網路) | Recorded from our API · 3 items shown · 26 datapoints per item GET /v1/591-house/rent-search?region\_id=1§ion\_ids\[\]=5&kind=2&price\_min=10000&price\_max=20000&sort=price\_asc 26 datapoints ### Identity - id integer - title string - kind\_name string - section\_id integer ### Contact - url url - owner\_type string ### Location - area\_ping number - address string - district string - street string - region\_id integer ### Reputation - photos string\[\] ### Price - price\_value integer - price\_text string - price\_unit string - price\_includes string ### Other - kind integer - floor\_text string - total\_floors integer - fitment string - tags string\[\] - transit object - has\_video boolean - refreshed\_text string - refreshed\_at string - views integer Playground ## Run this API cURL shell ``` curl "https://api.perceptlayer.com/v1/591-house/rent-search?region_id=1§ion_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`](https://perceptlayer.com/apis/591-house/locations) | none +2 optional | 1 credit | | [GET `/v1/591-house/locations-suggest`](https://perceptlayer.com/apis/591-house/locations-suggest) | `q` `region_id` | 1 credit | | [GET `/v1/591-house/rent-listing`](https://perceptlayer.com/apis/591-house/rent-listing) | `id` | 1 credit | | [GET `/v1/591-house/rent-search`](https://perceptlayer.com/apis/591-house/rent-search) | `region_id` +11 optional | 1 credit | | [GET `/v1/591-house/sale-listing`](https://perceptlayer.com/apis/591-house/sale-listing) | `id` | 1 credit | | [GET `/v1/591-house/sale-search`](https://perceptlayer.com/apis/591-house/sale-search) | `region_id` +13 optional | 1 credit | Overview ## About the 591 API ## 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§ion_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 estate JSON REST MCP ### More real estate APIs [28Hse](https://perceptlayer.com/apis/28hse) [4zida](https://perceptlayer.com/apis/4zida) [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) [Batdongsan.com.vn](https://perceptlayer.com/apis/batdongsan) 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](https://perceptlayer.com/signup) [Read the docs](https://docs.perceptlayer.com)