---
title: "Zigbang API: Search | Perceptlayer"
description: "Search from Zigbang as JSON. 1 credit per successful call."
url: https://perceptlayer.com/apis/zigbang/search
---

[APIs](https://perceptlayer.com/apis) / [Zigbang](https://perceptlayer.com/apis/zigbang) / Search

# Zigbang: Search

Search from Zigbang as JSON. 1 credit per successful call.

GET `/v1/zigbang/search`

## Parameters

Send parameters in the query string.

| Parameter | Type | Required | Allowed values |
| --- | --- | --- | --- |
| `property_type` | string | Required | oneroom, villa, officetel |
| `sales_type` | string | Optional | monthly\_rent, jeonse, sale |
| `lat` | number | Optional | Any |
| `lng` | number | Optional | Any |
| `subway_id` | integer | Optional | Any |
| `radius` | number | Optional | Any |
| `deposit_min` | integer | Optional | Any |
| `deposit_max` | integer | Optional | Any |
| `rent_min` | integer | Optional | Any |
| `rent_max` | integer | Optional | Any |
| `price_min` | integer | Optional | Any |
| `price_max` | integer | Optional | Any |
| `manage_cost_min` | integer | Optional | Any |
| `manage_cost_max` | integer | Optional | Any |
| `size_min` | number | Optional | Any |
| `size_max` | number | Optional | Any |
| `floor[]` | list of string | Optional | first, above\_ground, semi\_basement, rooftop |
| `room_type[]` | list of string | Optional | open\_studio, separate\_studio, duplex\_studio, two\_room, three\_room\_plus, four\_room\_plus |
| `bathroom_count` | integer | Optional | Any |
| `elevator` | boolean | Optional | Any |
| `parking` | boolean | Optional | Any |
| `pet` | boolean | Optional | Any |
| `cctv` | boolean | Optional | Any |
| `south_facing` | boolean | Optional | Any |
| `immediate_move` | boolean | Optional | Any |
| `loan_lease` | boolean | Optional | Any |
| `page` | integer | Optional | Any |
| `page_size` | integer | Optional | Any |

## Example request

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.

[Run this endpoint in the playground](https://perceptlayer.com/apis/zigbang?try=search#playground) with your own parameters. 1 credit per successful call; failed calls are free.
