APIs / 591 / Rent Search

591: Rent Search

Rent Search from 591 as JSON. 1 credit per successful call.

GET /v1/591-house/rent-search

Parameters

Send parameters in the query string.

Parameter	Type	Required	Allowed values
`region_id`	integer	Required	1, 2, 3, 4, 5, 6, 7, 8, 10, 11, 12, 13, 14, 15, 17, 19, 21, 22, 23, 24, 25, 26
`section_ids[]`	list of integer	Optional	Any
`kind`	integer	Optional	1, 2, 3, 4, 8
`price_min`	integer	Optional	Any
`price_max`	integer	Optional	Any
`area_min`	number	Optional	Any
`area_max`	number	Optional	Any
`keywords`	string	Optional	Up to 50 characters
`shape[]`	list of integer	Optional	1, 2, 3, 4
`layout[]`	list of integer	Optional	1, 2, 3, 4, 5
`sort`	string	Optional	price_asc, price_desc, newest
`page`	integer	Optional	Any

Example request

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.

Run this endpoint in the playground with your own parameters. 1 credit per successful call; failed calls are free.