--- title: "Sinyi Realty API: Search | Perceptlayer" description: "Search from Sinyi Realty as JSON. 1 credit per successful call." url: https://perceptlayer.com/apis/sinyi/search --- [APIs](https://perceptlayer.com/apis) / [Sinyi Realty](https://perceptlayer.com/apis/sinyi) / Search # Sinyi Realty: Search Search from Sinyi Realty as JSON. 1 credit per successful call. GET `/v1/sinyi/search` ## Parameters Send parameters in the query string. | Parameter | Type | Required | Allowed values | | --- | --- | --- | --- | | `trade` | string | Required | sale, rent | | `location` | string | Optional | Any | | `type` | string | Optional | apartment, high\_rise, mid\_rise, suite, villa, office, warehouse, store, factory, land, parking, other, whole\_home, private\_suite, shared\_suite, room | | `min_price` | integer | Optional | Any | | `max_price` | integer | Optional | Any | | `min_rooms` | integer | Optional | Any | | `max_rooms` | integer | Optional | Any | | `min_area` | number | Optional | Any | | `max_area` | number | Optional | Any | | `min_age` | integer | Optional | Any | | `max_age` | integer | Optional | Any | | `sort` | string | Optional | recommended, price\_desc, price\_asc, area\_asc, area\_desc, age\_asc, age\_desc, newest | | `page` | integer | Optional | Any | | `per_page` | integer | Optional | Any | ## Example request 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. [Run this endpoint in the playground](https://perceptlayer.com/apis/sinyi?try=search#playground) with your own parameters. 1 credit per successful call; failed calls are free.