APIs / Real estate / Zigbang

1 credit per call5 endpoints25 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.

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 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 2 items.

#idintegerurlurltitlestringproperty_typestringservice_typestringsales_typestringsales_type_codestringdeposit_manwonintegerdeposit_krwintegermanage_cost_krwintegersize_m2numbersize_pyeongintegersupply_size_m2numbersupply_size_pyeongintegerfloorintegerfloor_labelstringbuilding_floorintegerroom_type_codestringaddressstringaddress_detailobjectlatitudenumberlongitudenumberthumbnailurlregistered_atstringagency_idinteger
150626169https://www.zigbang.com/home/villa/items/50626169내외관 깔끔 엘베 주차villa빌라전세jeonse2300023000000012000036.41136.41144604서초구 반포동{5 fields}37.5039057968036127.019767059757https://ic.zigbang.com/ic/items/50626169/1.jpg2026-10-13T03:36:17Z14118530
250831901https://www.zigbang.com/home/villa/items/50831901버팀목등 대출가능 , 융자무 , 보증금 조절가능villa빌라전세jeonse2178021780000017000032.941032.941033404강남구 논현동{5 fields}37.5086669066932127.030307110921https://ic.zigbang.com/ic/items/50831901/1.jpg2026-10-23T05:47:00Z12847305

Recorded from our API · 2 items shown · 25 datapoints per itemGET /v1/zigbang/search?property_type=villa&sales_type=jeonse&lat=37.4979&lng=127.0276&deposit_max=30000&page_size=2

25 datapoints

Identity

  • idinteger
  • titlestring
  • property_typestring
  • service_typestring
  • sales_typestring
  • sales_type_codestring
  • room_type_codestring
  • agency_idinteger

Contact

  • urlurl

Location

  • addressstring
  • address_detailobject
  • latitudenumber
  • longitudenumber

Price

  • manage_cost_krwinteger

Other

  • deposit_manwoninteger
  • deposit_krwinteger
  • size_m2number
  • size_pyeonginteger
  • supply_size_m2number
  • supply_size_pyeonginteger
  • floorinteger
  • floor_labelstring
  • building_floorinteger
  • thumbnailurl
  • registered_atstring

Playground

Run this API

cURLshell
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.

EndpointRequired parametersCost
GET/v1/zigbang/agency
id
1 credit
GET/v1/zigbang/agency-listings
id+2 optional
1 credit
GET/v1/zigbang/autocomplete
q+2 optional
1 credit
GET/v1/zigbang/listing
id
1 credit
GET/v1/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 estateJSONRESTMCP

More real estate APIs

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.