Zigbang Agency Listings API Documentation List the active listings of one Zigbang agency with the same fields as the search endpoint. Page with page and page_size (up to 15). Zigbang sends no total, so the response reports has_more, which is true when a next page exists. An agency without active listings returns a successful, empty list. Prices are in man-won (10,000 KRW) next to the exact KRW value. Korean text is returned as Zigbang shows it.
Run this endpoint
Endpoint
Parameters
Start with the required fields, then add optional filters only when your use case needs them.
Runnable path
1 required parameter needed before sending a request.
2 optional filters available.
integer
Required
Zigbang agency id (agency_id in search results). Example: 161344.
1234567890
integer
Optional
Page number, starting at 1. Defaults to 1.
1
integer
Optional
Listings per page, 1 to 15. Defaults to 15.
10
Response Schema
Example response fields are illustrative; inspect the JSON before integrating.
Example response fields
Scan these fields before integrating.
data
meta
success
{
"data": {
"meta": {
"page": 1,
"has_more": true,
"page_size": 2
},
"results": [
{
"id": 50853811,
"url": "https://www.zigbang.com/home/officetel/items/50853811",
"floor": 2,
"title": "\ud004\ub9ac\ud2f0\ucd5c\uc815\uc0c1 \ud480\uc635\uc158 \uba74\uc801\uc798\ub098\uc634 \uc8fc\ucc28\ubb34\ub8cc \uc804\ub9dd\uc88b\uc74c LH\ub300\ucd9c",
"is_new": true,
"address": "\uc11c\ucd08\uad6c \uc11c\ucd08\ub3d9",
"size_m2": 23.1,
"latitude": 37.48525619506836,
"rent_krw": 300000,
"agency_id": 161344,
"longitude": 127.01310729980467,
"thumbnail": "https://ic.zigbang.com/ic/items/50853811/1.jpg",
"sales_type": "\uc6d4\uc138",
"deposit_krw": 116000000,
"floor_label": "2",
"rent_manwon": 30,
"size_pyeong": 7,
"service_type": "\uc624\ud53c\uc2a4\ud154",
"property_type": "officetel",
"registered_at": "2026-10-25T12:15:39Z",
"address_detail": {
"city": "\uc11c\ucd08\uad6c",
"district": "\uc11c\ucd08\ub3d9",
"province": "\uc11c\uc6b8\ud2b9\ubcc4\uc2dc",
"full_text": "\uc11c\uc6b8\ud2b9\ubcc4\uc2dc \uc11c\ucd08\uad6c \uc11c\ucd08\ub3d9",
"lot_number": "1589-8"
},
"building_floor": 10,
"deposit_manwon": 11600,
"room_type_code": "01",
"supply_size_m2": 42.91,
"manage_cost_krw": 110000,
"sales_type_code": "monthly_rent",
"supply_size_pyeong": 13
}
]
},
"meta": {
"billable": true,
"endpoint_family": "agency_listings"
},
"success": true
}Errors
Handle these documented responses before retrying or showing customer-facing failures.
Validation Error
The id is missing or a paging value is out of range. No upstream request is made. This response is not billable.
{
"errors": {
"page_size": [
"The page size must be 15 or fewer listings per page."
]
},
"message": "The request validation failed"
}Service Unavailable
Zigbang could not be reached, blocked every attempt, or answered with a shape that no longer matches the documented contract (error code PARSER_DRIFT). This response is not billable.
{
"meta": {
"billable": false,
"retryable": true,
"endpoint_family": "search"
},
"error": {
"code": "UPSTREAM_UNAVAILABLE",
"message": "The Zigbang API is temporarily unavailable. Please retry."
},
"success": false
}Generate Code with AI
Copy a ready-made prompt with all the endpoint details, parameters, and example responses. Paste it into ChatGPT, Claude, or any AI assistant to instantly generate working code.
Try It Live
Test this endpoint in our interactive playground with real data.