1 credit per call5 endpoints32 datapoints

Sinyi Realty API

Sinyi Realty API for Taiwan homes for sale or rent, with prices, discounts, ping and m² areas, listings and branches as JSON. 1 credit per successful call.

Get a free API key Run it below

Sinyi Realty

GET/v1/sinyi/search?trade=sale&location=106&min_price=20000000&max_price=30000000&sort=price_asc

{
  "success": true,
  "data": {
    "items": [
      {
        "id": "9069HC",
        "title": "●信義敦南●九龍",
        "url": "https://www.sinyi.com.tw/buy/house/9069HC",
        "share_url": "https://sinyi.in/o/9069HC/0/3",
        "listing_type": "sale",
        "property_types": [
          "high_rise",
          "office"
        ],
        "price": 20000000,
        "price_wan": 2000,
        "original_price": 16000000,
        "discount_percent": 25,
        "currency": "TWD",
        "area": {
          "building_ping": 10.61,
          "building_sqm": 35.07,
          "main_building_ping": 8.96,
          "main_building_sqm": 29.62,
          "land_ping": 1.13,
          "land_sqm": 3.74
        },
        "layout": "1廳1衛",
        "total_layout": "1廳1衛",
        "rooms": 0,
        "halls": 1,
        "bathrooms": 1,
        "floor": "6",
        "total_floors": 12,
        "age_years": 47.9,
        "is_presale": false,
        "has_parking": false,
        "address": "台北市大安區敦化南路二段",
        "zip_code": "106",
        "latitude": 25.032869880023,
        "longitude": 121.54920239332,
        "cover_image": "https://res.sinyi.com.tw/buy/9069HC/bigimg/A.JPG",
        "images": [
          "https://res.sinyi.com.tw/buy/9069HC/smallimg/A.JPG"
        ],
        "tag_codes": [
          "12",
          "10",
          "16"
        ],
        "views_3_months": 148,
        "has_vr": true,
        "has_video": false
      },
      {
        "id": "1806RD",
        "title": "科技大樓捷運站獨立辦公",
        "url": "https://www.sinyi.com.tw/buy/house/1806RD",
        "share_url": "https://sinyi.in/o/1806RD/0/3",
        "listing_type": "sale",
        "property_types": [
          "office",
          "high_rise"
        ],
        "price": 20180000,
        "price_wan": 2018,
        "original_price": 20180000,
        "discount_percent": 0,
        "currency": "TWD",
        "area": {
          "building_ping": 18.68,
          "building_sqm": 61.75,
          "main_building_ping": 12.23,
          "main_building_sqm": 40.43,
          "land_ping": 2.01,
          "land_sqm": 6.64
        },
        "layout": "1廳1衛",
        "total_layout": "1廳1衛",
        "rooms": 0,
        "halls": 1,
        "bathrooms": 1,
        "floor": "9",
        "total_floors": 14,
        "age_years": 29.8,
        "is_presale": false,
        "has_parking": false,
        "address": "台北市大安區復興南路二段",
        "zip_code": "106",
        "latitude": 25.025846,
        "longitude": 121.54371,
        "cover_image": "https://res.sinyi.com.tw/buy/1806RD/bigimg/A.JPG",
        "images": [
          "https://res.sinyi.com.tw/buy/1806RD/smallimg/A.JPG"
        ],
        "tag_codes": [
          "7",
          "12",
          "10"
        ],
        "views_3_months": 241,
        "has_vr": true,
        "has_video": false
      },
      {
        "id": "4516XF",
        "title": "捷運公園芳和實中電梯兩房",
        "url": "https://www.sinyi.com.tw/buy/house/4516XF",
        "share_url": "https://sinyi.in/o/4516XF/0/3",
        "listing_type": "sale",
        "property_types": [
          "mid_rise"
        ],
        "price": 20280000,
        "price_wan": 2028,
        "original_price": 20280000,
        "discount_percent": 0,
        "currency": "TWD",
        "area": {
          "building_ping": 21.12,
          "building_sqm": 69.82,
          "main_building_ping": 17.02,
          "main_building_sqm": 56.26,
          "land_ping": 3.23,
          "land_sqm": 10.68
        },
        "layout": "2房2廳1衛",
        "total_layout": "2房2廳1衛",
        "rooms": 2,
        "halls": 2,
        "bathrooms": 1,
        "floor": "4",
        "total_floors": 7,
        "age_years": 42.4,
        "is_presale": false,
        "has_parking": false,
        "address": "台北市大安區安居街",
        "zip_code": "106",
        "latitude": 25.019957,
        "longitude": 121.553882,
        "community": {
          "id": "0007946",
          "name": "敦南白宮"
        },
        "cover_image": "https://res.sinyi.com.tw/buy/4516XF/bigimg/A.JPG",
        "images": [
          "https://res.sinyi.com.tw/buy/4516XF/smallimg/A.JPG"
        ],
        "tag_codes": [
          "7",
          "3",
          "4"
        ],
        "views_3_months": 475,
        "has_vr": true,
        "has_video": false
      }
    ],
    "pagination": {
      "page": 1,
      "per_page": 30,
      "total": 122,
      "total_pages": 5,
      "returned": 30,
      "dropped_by_filter": 0,
      "has_more": true
    },
    "query": {
      "trade": "sale",
      "sort": "price_asc",
      "location": "106",
      "min_price": "20000000",
      "max_price": "30000000"
    }
  },
  "meta": {
    "endpoint_family": "search",
    "request_id": "req_8f0e8e8ad49c469cbaf599efa7dae017",
    "credits_charged": 1,
    "credits_remaining": 1812
  }
}

200 OKJSONX-Credits-Used: 1

Recorded from our API and shortened.

Sample data

What one call returns

A recorded run of search: the fields and shapes you will get, shortened to 3 items.

#	idstring	titlestring	urlurl	share_urlurl	listing_typestring	property_typesstring[]	priceinteger	price_waninteger	original_priceinteger	discount_percentinteger	currencystring	areaobject	layoutstring	total_layoutstring	roomsinteger	hallsinteger	bathroomsinteger	floorstring	total_floorsinteger	age_yearsnumber	is_presaleboolean	has_parkingboolean	addressstring	zip_codestring	latitudenumber	longitudenumber	cover_imageurl	imagesstring[]	tag_codesstring[]	views_3_monthsinteger	has_vrboolean	has_videoboolean
1	9069HC	●信義敦南●九龍	https://www.sinyi.com.tw/buy/house/9069HC	https://sinyi.in/o/9069HC/0/3	sale	[2 items]	20000000	2000	16000000	25	TWD	{6 fields}	1廳1衛	1廳1衛	0	1	1	6	12	47.9	false	false	台北市大安區敦化南路二段	106	25.032869880023	121.54920239332	https://res.sinyi.com.tw/buy/9069HC/bigimg/A.JPG	[1 item]	[3 items]	148	true	false
2	1806RD	科技大樓捷運站獨立辦公	https://www.sinyi.com.tw/buy/house/1806RD	https://sinyi.in/o/1806RD/0/3	sale	[2 items]	20180000	2018	20180000	0	TWD	{6 fields}	1廳1衛	1廳1衛	0	1	1	9	14	29.8	false	false	台北市大安區復興南路二段	106	25.025846	121.54371	https://res.sinyi.com.tw/buy/1806RD/bigimg/A.JPG	[1 item]	[3 items]	241	true	false
3	4516XF	捷運公園芳和實中電梯兩房	https://www.sinyi.com.tw/buy/house/4516XF	https://sinyi.in/o/4516XF/0/3	sale	[1 item]	20280000	2028	20280000	0	TWD	{6 fields}	2房2廳1衛	2房2廳1衛	2	2	1	4	7	42.4	false	false	台北市大安區安居街	106	25.019957	121.553882	https://res.sinyi.com.tw/buy/4516XF/bigimg/A.JPG	[1 item]	[3 items]	475	true	false

[
  {
    "id": "9069HC",
    "title": "●信義敦南●九龍",
    "url": "https://www.sinyi.com.tw/buy/house/9069HC",
    "share_url": "https://sinyi.in/o/9069HC/0/3",
    "listing_type": "sale",
    "property_types": [
      "high_rise",
      "office"
    ],
    "price": 20000000,
    "price_wan": 2000,
    "original_price": 16000000,
    "discount_percent": 25,
    "currency": "TWD",
    "area": {
      "building_ping": 10.61,
      "building_sqm": 35.07,
      "main_building_ping": 8.96,
      "main_building_sqm": 29.62,
      "land_ping": 1.13,
      "land_sqm": 3.74
    },
    "layout": "1廳1衛",
    "total_layout": "1廳1衛",
    "rooms": 0,
    "halls": 1,
    "bathrooms": 1,
    "floor": "6",
    "total_floors": 12,
    "age_years": 47.9,
    "is_presale": false,
    "has_parking": false,
    "address": "台北市大安區敦化南路二段",
    "zip_code": "106",
    "latitude": 25.032869880023,
    "longitude": 121.54920239332,
    "cover_image": "https://res.sinyi.com.tw/buy/9069HC/bigimg/A.JPG",
    "images": [
      "https://res.sinyi.com.tw/buy/9069HC/smallimg/A.JPG"
    ],
    "tag_codes": [
      "12",
      "10",
      "16"
    ],
    "views_3_months": 148,
    "has_vr": true,
    "has_video": false
  },
  {
    "id": "1806RD",
    "title": "科技大樓捷運站獨立辦公",
    "url": "https://www.sinyi.com.tw/buy/house/1806RD",
    "share_url": "https://sinyi.in/o/1806RD/0/3",
    "listing_type": "sale",
    "property_types": [
      "office",
      "high_rise"
    ],
    "price": 20180000,
    "price_wan": 2018,
    "original_price": 20180000,
    "discount_percent": 0,
    "currency": "TWD",
    "area": {
      "building_ping": 18.68,
      "building_sqm": 61.75,
      "main_building_ping": 12.23,
      "main_building_sqm": 40.43,
      "land_ping": 2.01,
      "land_sqm": 6.64
    },
    "layout": "1廳1衛",
    "total_layout": "1廳1衛",
    "rooms": 0,
    "halls": 1,
    "bathrooms": 1,
    "floor": "9",
    "total_floors": 14,
    "age_years": 29.8,
    "is_presale": false,
    "has_parking": false,
    "address": "台北市大安區復興南路二段",
    "zip_code": "106",
    "latitude": 25.025846,
    "longitude": 121.54371,
    "cover_image": "https://res.sinyi.com.tw/buy/1806RD/bigimg/A.JPG",
    "images": [
      "https://res.sinyi.com.tw/buy/1806RD/smallimg/A.JPG"
    ],
    "tag_codes": [
      "7",
      "12",
      "10"
    ],
    "views_3_months": 241,
    "has_vr": true,
    "has_video": false
  },
  {
    "id": "4516XF",
    "title": "捷運公園芳和實中電梯兩房",
    "url": "https://www.sinyi.com.tw/buy/house/4516XF",
    "share_url": "https://sinyi.in/o/4516XF/0/3",
    "listing_type": "sale",
    "property_types": [
      "mid_rise"
    ],
    "price": 20280000,
    "price_wan": 2028,
    "original_price": 20280000,
    "discount_percent": 0,
    "currency": "TWD",
    "area": {
      "building_ping": 21.12,
      "building_sqm": 69.82,
      "main_building_ping": 17.02,
      "main_building_sqm": 56.26,
      "land_ping": 3.23,
      "land_sqm": 10.68
    },
    "layout": "2房2廳1衛",
    "total_layout": "2房2廳1衛",
    "rooms": 2,
    "halls": 2,
    "bathrooms": 1,
    "floor": "4",
    "total_floors": 7,
    "age_years": 42.4,
    "is_presale": false,
    "has_parking": false,
    "address": "台北市大安區安居街",
    "zip_code": "106",
    "latitude": 25.019957,
    "longitude": 121.553882,
    "community": {
      "id": "0007946",
      "name": "敦南白宮"
    },
    "cover_image": "https://res.sinyi.com.tw/buy/4516XF/bigimg/A.JPG",
    "images": [
      "https://res.sinyi.com.tw/buy/4516XF/smallimg/A.JPG"
    ],
    "tag_codes": [
      "7",
      "3",
      "4"
    ],
    "views_3_months": 475,
    "has_vr": true,
    "has_video": false
  }
]

id,title,url,share_url,listing_type,property_types,price,price_wan,original_price,discount_percent,currency,area,layout,total_layout,rooms,halls,bathrooms,floor,total_floors,age_years,is_presale,has_parking,address,zip_code,latitude,longitude,cover_image,images,tag_codes,views_3_months,has_vr,has_video
9069HC,●信義敦南●九龍,https://www.sinyi.com.tw/buy/house/9069HC,https://sinyi.in/o/9069HC/0/3,sale,"[""high_rise"",""office""]",20000000,2000,16000000,25,TWD,"{""building_ping"":10.61,""building_sqm"":35.07,""main_building_ping"":8.96,""main_building_sqm"":29.62,""land_ping"":1.13,""land_sqm"":3.74}",1廳1衛,1廳1衛,0,1,1,6,12,47.9,false,false,台北市大安區敦化南路二段,106,25.032869880023,121.54920239332,https://res.sinyi.com.tw/buy/9069HC/bigimg/A.JPG,"[""https://res.sinyi.com.tw/buy/9069HC/smallimg/A.JPG""]","[""12"",""10"",""16""]",148,true,false
1806RD,科技大樓捷運站獨立辦公,https://www.sinyi.com.tw/buy/house/1806RD,https://sinyi.in/o/1806RD/0/3,sale,"[""office"",""high_rise""]",20180000,2018,20180000,0,TWD,"{""building_ping"":18.68,""building_sqm"":61.75,""main_building_ping"":12.23,""main_building_sqm"":40.43,""land_ping"":2.01,""land_sqm"":6.64}",1廳1衛,1廳1衛,0,1,1,9,14,29.8,false,false,台北市大安區復興南路二段,106,25.025846,121.54371,https://res.sinyi.com.tw/buy/1806RD/bigimg/A.JPG,"[""https://res.sinyi.com.tw/buy/1806RD/smallimg/A.JPG""]","[""7"",""12"",""10""]",241,true,false
4516XF,捷運公園芳和實中電梯兩房,https://www.sinyi.com.tw/buy/house/4516XF,https://sinyi.in/o/4516XF/0/3,sale,"[""mid_rise""]",20280000,2028,20280000,0,TWD,"{""building_ping"":21.12,""building_sqm"":69.82,""main_building_ping"":17.02,""main_building_sqm"":56.26,""land_ping"":3.23,""land_sqm"":10.68}",2房2廳1衛,2房2廳1衛,2,2,1,4,7,42.4,false,false,台北市大安區安居街,106,25.019957,121.553882,https://res.sinyi.com.tw/buy/4516XF/bigimg/A.JPG,"[""https://res.sinyi.com.tw/buy/4516XF/smallimg/A.JPG""]","[""7"",""3"",""4""]",475,true,false

Recorded from our API · 3 items shown · 32 datapoints per itemGET /v1/sinyi/search?trade=sale&location=106&min_price=20000000&max_price=30000000&sort=price_asc

32 datapoints

Identity

idstring
titlestring
listing_typestring
property_typesstring[]

Contact

urlurl
share_urlurl

Location

areaobject
addressstring
zip_codestring
latitudenumber
longitudenumber

Reputation

cover_imageurl
imagesstring[]

Price

priceinteger
price_waninteger
original_priceinteger
discount_percentinteger
currencystring

Other

layoutstring
total_layoutstring
roomsinteger
hallsinteger
bathroomsinteger
floorstring
total_floorsinteger
age_yearsnumber
is_presaleboolean
has_parkingboolean
tag_codesstring[]
views_3_monthsinteger
has_vrboolean
has_videoboolean

Playground

Run this API

cURLshell

curl "https://api.perceptlayer.com/v1/sinyi/search?trade=sale&location=106&min_price=20000000&max_price=30000000&sort=price_asc" \
  -H "X-API-Key: $API_KEY"

Sinyi Realty · 5 endpoints

Endpoints

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

Endpoint	Required parameters	Cost
GET`/v1/sinyi/agency`	`id`	1 credit
GET`/v1/sinyi/autocomplete`	`q`	1 credit
GET`/v1/sinyi/listing`	`id`	1 credit
GET`/v1/sinyi/locations`	none+1 optional	1 credit
GET`/v1/sinyi/search`	`trade`+13 optional	1 credit

Overview

What you can get

The Sinyi Realty API returns Sinyi Realty property data as JSON through 5 endpoints.

Search: search takes a trade (sale or rent), with location, type (apartment, high_rise, mid_rise, suite, villa, office, warehouse, store, factory, land, parking, other, whole_home, private_suite, shared_suite or room), min_price, max_price, min_rooms, max_rooms, min_area, max_area, min_age, max_age, sort (recommended, price_desc, price_asc, area_asc, area_desc, age_asc, age_desc or newest), page and per_page.
Listings: listing takes an id.
Agencies: agency takes an id.
Locations: locations takes a city_id; autocomplete takes a q.

The recorded search for homes for sale in postcode 106 (Da'an District, Taipei) between 20,000,000 and 30,000,000 TWD, sorted by price_asc, returns pagination with a total of 122, and items, each with id, title, url, property_types, price, price_wan, original_price, discount_percent, currency, area, layout, rooms, halls, bathrooms, floor, total_floors, age_years, has_parking, address, zip_code, latitude, longitude, images, views_3_months, has_vr and has_video.

How a call works

Search an area: GET /v1/sinyi/search?trade=sale&location=106&min_price=20000000&max_price=30000000&sort=price_asc with your key in the X-API-Key header. Each item's id (such as 9069HC) is what listing takes. Check has_more in pagination before asking for the next page. Every successful call costs 1 credit; failed calls cost nothing.

Real estateJSONRESTMCP

More real estate APIs

Use cases

Track asking prices for homes in a Taiwan district

Use the Sinyi Realty API to track asking prices for homes in a Taiwan district

Watch price cuts with `original_price` and `discount_percent`

Use the Sinyi Realty API to watch price cuts with `original_price` and `discount_percent`

Compare asking prices by building age with `min_age` and `max_age`

Use the Sinyi Realty API to compare asking prices by building age with `min_age` and `max_age`

Gauge buyer interest with `views_3_months`

Use the Sinyi Realty API to gauge buyer interest with `views_3_months`

FAQ

Questions

Do I need a Sinyi Realty account?

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

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

Are areas in ping or square metres?

Both. `area` returns `building_ping` and `building_sqm`, `main_building_ping` and `main_building_sqm`, and `land_ping` and `land_sqm`.

Should I build a Sinyi Realty scraper instead?

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

No credit card. Failed calls are never billed.

Get a free API key Read the docs