--- title: "Sinyi Realty API: JSON data, 5 endpoints, 1 credit per call" description: "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." url: https://perceptlayer.com/apis/sinyi --- [APIs](https://perceptlayer.com/apis) / [Real estate](https://perceptlayer.com/verticals/real-estate) / Sinyi Realty 1 credit per call 5 endpoints 32 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](https://perceptlayer.com/signup) 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 OK JSON X-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. | # | id string | title string | url url | share\_url url | listing\_type string | property\_types string\[\] | price integer | price\_wan integer | original\_price integer | discount\_percent integer | currency string | area object | layout string | total\_layout string | rooms integer | halls integer | bathrooms integer | floor string | total\_floors integer | age\_years number | is\_presale boolean | has\_parking boolean | address string | zip\_code string | latitude number | longitude number | cover\_image url | images string\[\] | tag\_codes string\[\] | views\_3\_months integer | has\_vr boolean | has\_video boolean | | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | 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 | Recorded from our API · 3 items shown · 32 datapoints per item GET /v1/sinyi/search?trade=sale&location=106&min\_price=20000000&max\_price=30000000&sort=price\_asc 32 datapoints ### Identity - id string - title string - listing\_type string - property\_types string\[\] ### Contact - url url - share\_url url ### Location - area object - address string - zip\_code string - latitude number - longitude number ### Reputation - cover\_image url - images string\[\] ### Price - price integer - price\_wan integer - original\_price integer - discount\_percent integer - currency string ### Other - layout string - total\_layout string - rooms integer - halls integer - bathrooms integer - floor string - total\_floors integer - age\_years number - is\_presale boolean - has\_parking boolean - tag\_codes string\[\] - views\_3\_months integer - has\_vr boolean - has\_video boolean Playground ## Run this API cURL shell ``` 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`](https://perceptlayer.com/apis/sinyi/agency) | `id` | 1 credit | | [GET `/v1/sinyi/autocomplete`](https://perceptlayer.com/apis/sinyi/autocomplete) | `q` | 1 credit | | [GET `/v1/sinyi/listing`](https://perceptlayer.com/apis/sinyi/listing) | `id` | 1 credit | | [GET `/v1/sinyi/locations`](https://perceptlayer.com/apis/sinyi/locations) | none +1 optional | 1 credit | | [GET `/v1/sinyi/search`](https://perceptlayer.com/apis/sinyi/search) | `trade` +13 optional | 1 credit | Overview ## About the Sinyi Realty API ## 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 estate JSON REST MCP ### More real estate APIs [28Hse](https://perceptlayer.com/apis/28hse) [4zida](https://perceptlayer.com/apis/4zida) [591](https://perceptlayer.com/apis/591-house) [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) 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](https://perceptlayer.com/signup) [Read the docs](https://docs.perceptlayer.com)