--- title: "Zigbang API: JSON data, 5 endpoints, 1 credit per call" description: "Zigbang API for Korean one-rooms, villas and officetels on monthly rent, jeonse or sale, with listings and agencies as JSON. 1 credit per successful call." url: https://perceptlayer.com/apis/zigbang --- [APIs](https://perceptlayer.com/apis) / [Real estate](https://perceptlayer.com/verticals/real-estate) / Zigbang 1 credit per call 5 endpoints 25 datapoints # Zigbang API Zigbang API for Korean one-rooms, villas and officetels on monthly rent, jeonse or sale, with listings and agencies as JSON. 1 credit per successful call. [Get a free API key](https://perceptlayer.com/signup) Run it below Zigbang GET /v1/zigbang/search?property\_type=villa&sales\_type=jeonse&lat=37.4979&lng=127.0276&deposit\_max=30000&page\_size=2 ``` { "success": true, "data": { "results": [ { "id": 50626169, "url": "https://www.zigbang.com/home/villa/items/50626169", "title": "내외관 깔끔 엘베 주차", "property_type": "villa", "service_type": "빌라", "sales_type": "전세", "sales_type_code": "jeonse", "deposit_manwon": 23000, "deposit_krw": 230000000, "manage_cost_krw": 120000, "size_m2": 36.4, "size_pyeong": 11, "supply_size_m2": 36.4, "supply_size_pyeong": 11, "floor": 4, "floor_label": "4", "building_floor": 6, "room_type_code": "04", "address": "서초구 반포동", "address_detail": { "province": "서울시", "city": "서초구", "district": "반포동", "lot_number": "742-11", "full_text": "서울시 서초구 반포동" }, "latitude": 37.5039057968036, "longitude": 127.019767059757, "thumbnail": "https://ic.zigbang.com/ic/items/50626169/1.jpg", "registered_at": "2026-10-13T03:36:17Z", "agency_id": 14118530 }, { "id": 50831901, "url": "https://www.zigbang.com/home/villa/items/50831901", "title": "버팀목등 대출가능 , 융자무 , 보증금 조절가능", "property_type": "villa", "service_type": "빌라", "sales_type": "전세", "sales_type_code": "jeonse", "deposit_manwon": 21780, "deposit_krw": 217800000, "manage_cost_krw": 170000, "size_m2": 32.94, "size_pyeong": 10, "supply_size_m2": 32.94, "supply_size_pyeong": 10, "floor": 3, "floor_label": "3", "building_floor": 4, "room_type_code": "04", "address": "강남구 논현동", "address_detail": { "province": "서울시", "city": "강남구", "district": "논현동", "lot_number": "177-36", "full_text": "서울시 강남구 논현동" }, "latitude": 37.5086669066932, "longitude": 127.030307110921, "thumbnail": "https://ic.zigbang.com/ic/items/50831901/1.jpg", "registered_at": "2026-10-23T05:47:00Z", "agency_id": 12847305 } ], "meta": { "total_count": 17, "total_pages": 9, "page": 1, "page_size": 2, "has_more": true, "filtered_out": 0 } }, "meta": { "endpoint_family": "search", "filtered_out": 0, "request_id": "req_8ac51fa8a11d47fa8df259c239024685", "credits_charged": 1, "credits_remaining": 1800 } } ``` 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 2 items. | # | id integer | url url | title string | property\_type string | service\_type string | sales\_type string | sales\_type\_code string | deposit\_manwon integer | deposit\_krw integer | manage\_cost\_krw integer | size\_m2 number | size\_pyeong integer | supply\_size\_m2 number | supply\_size\_pyeong integer | floor integer | floor\_label string | building\_floor integer | room\_type\_code string | address string | address\_detail object | latitude number | longitude number | thumbnail url | registered\_at string | agency\_id integer | | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | 1 | 50626169 | https://www.zigbang.com/home/villa/items/50626169 | 내외관 깔끔 엘베 주차 | villa | 빌라 | 전세 | jeonse | 23000 | 230000000 | 120000 | 36.4 | 11 | 36.4 | 11 | 4 | 4 | 6 | 04 | 서초구 반포동 | {5 fields} | 37.5039057968036 | 127.019767059757 | https://ic.zigbang.com/ic/items/50626169/1.jpg | 2026-10-13T03:36:17Z | 14118530 | | 2 | 50831901 | https://www.zigbang.com/home/villa/items/50831901 | 버팀목등 대출가능 , 융자무 , 보증금 조절가능 | villa | 빌라 | 전세 | jeonse | 21780 | 217800000 | 170000 | 32.94 | 10 | 32.94 | 10 | 3 | 3 | 4 | 04 | 강남구 논현동 | {5 fields} | 37.5086669066932 | 127.030307110921 | https://ic.zigbang.com/ic/items/50831901/1.jpg | 2026-10-23T05:47:00Z | 12847305 | Recorded from our API · 2 items shown · 25 datapoints per item GET /v1/zigbang/search?property\_type=villa&sales\_type=jeonse&lat=37.4979&lng=127.0276&deposit\_max=30000&page\_size=2 25 datapoints ### Identity - id integer - title string - property\_type string - service\_type string - sales\_type string - sales\_type\_code string - room\_type\_code string - agency\_id integer ### Contact - url url ### Location - address string - address\_detail object - latitude number - longitude number ### Price - manage\_cost\_krw integer ### Other - deposit\_manwon integer - deposit\_krw integer - size\_m2 number - size\_pyeong integer - supply\_size\_m2 number - supply\_size\_pyeong integer - floor integer - floor\_label string - building\_floor integer - thumbnail url - registered\_at string Playground ## Run this API cURL shell ``` curl "https://api.perceptlayer.com/v1/zigbang/search?property_type=villa&sales_type=jeonse&lat=37.4979&lng=127.0276&deposit_max=30000&page_size=2" \ -H "X-API-Key: $API_KEY" ``` Zigbang · 5 endpoints ## Endpoints Every endpoint takes the same key. Open one for its parameters and an example request. | Endpoint | Required parameters | Cost | | --- | --- | --- | | [GET `/v1/zigbang/agency`](https://perceptlayer.com/apis/zigbang/agency) | `id` | 1 credit | | [GET `/v1/zigbang/agency-listings`](https://perceptlayer.com/apis/zigbang/agency-listings) | `id` +2 optional | 1 credit | | [GET `/v1/zigbang/autocomplete`](https://perceptlayer.com/apis/zigbang/autocomplete) | `q` +2 optional | 1 credit | | [GET `/v1/zigbang/listing`](https://perceptlayer.com/apis/zigbang/listing) | `id` | 1 credit | | [GET `/v1/zigbang/search`](https://perceptlayer.com/apis/zigbang/search) | `property_type` +27 optional | 1 credit | Overview ## About the Zigbang API ## What you can get The Zigbang API returns Zigbang property data as JSON through 5 endpoints. - **Search:** `search` takes a `property_type` (oneroom, villa or officetel), with `sales_type` (monthly\_rent, jeonse or sale), `lat`, `lng`, `radius` or `subway_id`, `deposit_min`, `deposit_max`, `rent_min`, `rent_max`, `price_min`, `price_max`, `manage_cost_min`, `manage_cost_max`, `size_min`, `size_max`, `floor[]` and `room_type[]` (repeatable), `bathroom_count`, `elevator`, `parking`, `pet`, `cctv`, `south_facing`, `immediate_move`, `loan_lease`, `page` and `page_size`. - **Listings:** `listing` takes an `id`. - **Agencies:** `agency` takes an `id`; `agency-listings` takes an `id`, with `page` and `page_size`. - **Autocomplete:** `autocomplete` takes a `q`, with `service` (oneroom, villa, officetel or apartment) and `limit`. The recorded `search` for villas on jeonse around `lat=37.4979` and `lng=127.0276` in Seoul, with `deposit_max=30000` returns `meta` with a `total_count` of 17, `total_pages` and `has_more`, and `results`, each with `id`, `url`, `title`, `property_type`, `sales_type`, `deposit_manwon`, `deposit_krw`, `manage_cost_krw`, `size_m2`, `size_pyeong`, `floor`, `building_floor`, `address`, `latitude`, `longitude`, `registered_at` and `agency_id`. ## How a call works Search around a point: `GET /v1/zigbang/search?property_type=villa&sales_type=jeonse&lat=37.4979&lng=127.0276&deposit_max=30000&page_size=2` with your key in the `X-API-Key` header. Each result's `id` is what `listing` takes, and its `agency_id` is what `agency` and `agency-listings` take as `id`. Check `has_more` 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 jeonse deposits and monthly rents for villas and officetels in Seoul `Use the Zigbang API to track jeonse deposits and monthly rents for villas and officetels in Seoul` ### Compare maintenance costs with \`manage\_cost\_krw\` `` Use the Zigbang API to compare maintenance costs with `manage_cost_krw` `` ### Find rentals near a subway station with \`subway\_id\` `` Use the Zigbang API to find rentals near a subway station with `subway_id` `` ### Filter for pets, parking, elevators or loan-eligible leases `Use the Zigbang API to filter for pets, parking, elevators or loan-eligible leases` FAQ ## Questions **Do I need a Zigbang account?** No. You call this Zigbang API with your Perceptlayer key in the \`X-API-Key\` header, with no Zigbang login. **How much does the Zigbang 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. **What units are deposits and sizes in?** Each result gives the deposit in both \`deposit\_manwon\` and \`deposit\_krw\`, and the size in both \`size\_m2\` and \`size\_pyeong\`. **Should I build a Zigbang scraper instead?** You can, but a Zigbang scraper is code you maintain: page changes break it, requests get blocked, and Zigbang's terms govern how you collect data. The Zigbang 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 Zigbang 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)