Skip to Content
API Reference591 Rent

591 Rent API

Taiwan’s largest rental listing platform (rent.591.com.tw) — search listings and get details.

  • Listings: Search rental properties by region, type, and price
  • Details: Get full listing info including facilities, contact, and description

Listings

GET /rent591/listings — 2 credits

Search rental listings on 591.com.tw.

ParamTypeRequiredDefaultDescription
regionintegerNo1Region ID (1=台北市, 3=新北市, 6=桃園市, 5=新竹市, 8=台中市, 15=台南市, 17=高雄市)
first_rowintegerNo0Pagination offset (0, 30, 60, …)
kindintegerNo—Property type (1=整層住家, 2=獨立套房, 3=分租套房, 4=雅房, 8=車位)
sectionintegerNo—Section/district ID within the region
pricestringNo—Price range (e.g. 5000_10000$, 10000_20000$)
countintegerNo30Number of listings (max 30)
curl -H "x-api-key: sk_byc_xxx" \
  "https://api.bycrawl.com/rent591/listings?region=1&kind=2&price=10000_20000$"

Response

{
  "total": 13576,
  "listings": [
    {
      "id": 20734125,
      "title": "近捷運獨立套房",
      "url": "https://rent.591.com.tw/20734125",
      "kind": "獨立套房",
      "price": "15,200",
      "priceUnit": "元/月",
      "address": "中山區-長春路",
      "area": "6.8坪",
      "floor": "4F/12F",
      "communityName": "世界觀光大廈",
      "communityId": 5627,
      "roleName": "仲介陳小姐",
      "browseCount": 429,
      "refreshTime": "20天前更新",
      "cover": "https://img1.591.com.tw/house/2026/02/25/xxx.jpg",
      "tags": ["近捷運", "拎包入住", "有電梯"]
    }
  ],
  "firstRow": 0
}

GET /rent591/listings/:listingId — 2 credits

Get a rental listing detail by ID.

ParamTypeRequiredDefaultDescription
listingIdintegerYes—591 listing ID
curl -H "x-api-key: sk_byc_xxx" \
  https://api.bycrawl.com/rent591/listings/20734125

Response

{
  "id": 20734125,
  "title": "近捷運獨立套房",
  "url": "https://rent.591.com.tw/20734125",
  "status": "open",
  "kind": 2,
  "regionId": 1,
  "sectionId": 3,
  "price": "15,200",
  "priceUnit": "元/月",
  "deposit": "押金二個月",
  "address": "中山區長春路",
  "communityName": "世界觀光大廈",
  "tags": ["近捷運", "拎包入住"],
  "facilities": ["冰箱", "洗衣機", "冷氣", "網路"],
  "description": "近捷運站，交通便利...",
  "contact": {
    "name": "陳小姐",
    "role": "仲介",
    "company": "聯勝開發有限公司"
  }
}
PTTWeb Fetch