# Zigbang Listing Detail API Documentation

<p><strong>Zigbang Listing Detail API Documentation</strong> Get one Zigbang (직방) listing by id: Korean title and description, status, property and sales type, deposit, rent or sale price in man-won and KRW, maintenance fee with the included and excluded items, exclusive and contract area, floor, building floors, room type, bathrooms, direction, residence type, approval date, parking, elevator, move-in date, all photos, option list (air conditioner, refrigerator and more), full address with lot number, legal-dong code and PNU, coordinates, nearby places with walking distance, area tags and the agency office (name, office phone, address and registration numbers). The agent's personal name, mobile phone and email are never returned. Use an id from the search endpoint. An unknown or closed listing returns 404 and is not billed.</p>

- **Documentation:** [https://scrappa.co/docs/zigbang-api/zigbang_listing](https://scrappa.co/docs/zigbang-api/zigbang_listing)
- **API group:** Zigbang API
- **Endpoint:** `GET https://scrappa.co/api/zigbang/listing`

## Authentication

Send your Scrappa API key in the `X-API-KEY` request header. Paid endpoints also support accountless x402 payments when called without an API key.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `id` | integer | Yes | Zigbang listing id from the search endpoint. Example: 50626169. |

## Example response

```json
{
    "data": {
        "listing": {
            "id": 50626169,
            "url": "https://www.zigbang.com/home/villa/items/50626169",
            "floor": 4,
            "title": "\ub0b4\uc678\uad00 \uae54\ub054 \uc5d8\ubca0 \uc8fc\ucc28",
            "agency": {
                "id": 14118530,
                "office_name": "\uc6d4\ub4dc\uacf5\uc778\uc911\uac1c\uc0ac\uc0ac\ubb34\uc18c",
                "office_phone": "0212345678",
                "office_address": "\uc11c\uc6b8\ud2b9\ubcc4\uc2dc \uc11c\ucd08\uad6c \uc8fc\ud765\uae38 3 , 1\uce35\uc81c111\ud638(\ubc18\ud3ec\ub3d9)",
                "office_registration_number": "11650-2023-00036",
                "company_registration_number": "1510702362"
            },
            "images": [
                "https://ic.zigbang.com/ic/items/50626169/1.jpg",
                "https://ic.zigbang.com/ic/items/50626169/2.jpg",
                "https://ic.zigbang.com/ic/items/50626169/3.jpg"
            ],
            "status": "open",
            "address": {
                "pnu": "1165010700107420011",
                "city": "\uc11c\ucd08\uad6c",
                "jibun": "\uc11c\ucd08\uad6c \ubc18\ud3ec\ub3d9 742-11",
                "district": "\ubc18\ud3ec\ub3d9",
                "province": "\uc11c\uc6b8\uc2dc",
                "full_text": "\uc11c\uc6b8\uc2dc \uc11c\ucd08\uad6c \ubc18\ud3ec\ub3d9",
                "legal_dong_code": "1165010700"
            },
            "options": [
                {
                    "code": "01",
                    "name": "\uc5d0\uc5b4\ucee8"
                },
                {
                    "code": "03",
                    "name": "\uc138\ud0c1\uae30"
                },
                {
                    "code": "05",
                    "name": "\uc778\ub355\uc158"
                },
                {
                    "code": "11",
                    "name": "\uc2e0\ubc1c\uc7a5"
                },
                {
                    "code": "12",
                    "name": "\uc2f1\ud06c\ub300"
                }
            ],
            "size_m2": 36.4,
            "latitude": 37.5039057968036,
            "area_tags": [
                "\ub354\ube14\uc5ed\uc138\uad8c",
                "\uc2ac\uc138\uad8c",
                "\uacf5\uc138\uad8c",
                "\ud559\uc138\uad8c"
            ],
            "direction": "E",
            "longitude": 127.019767059757,
            "room_type": "\ud22c\ub8f8",
            "thumbnail": "https://ic.zigbang.com/ic/items/50626169/1.jpg",
            "sales_type": "\uc804\uc138",
            "updated_at": "2026-10-13T03:36:17Z",
            "deposit_krw": 230000000,
            "description": "\u25b6\ub0b4\uc678\uad00 \uae54\ub054\ud55c \ud22c\ub8f8\uc785\ub2c8\ub2e4.\n\n\u25b6\uc2e0\ub17c\ud6045\ubd84\uac70\ub9ac \uc704\uce58 \uc88b\uc2b5\ub2c8\ub2e4.\n\n\u25b6\uc735\uc790 \uc804\ud600 \uc5c6\uc2b5\ub2c8\ub2e4.\n\n\u25b6\uacf5\ub3d9\ud604\uad00,CCTV\ub4f1 \ubcf4\uc548 \uc88b\uc2b5\ub2c8\ub2e4.\n\n\u25b6\uc8fc\ucc281\ub300 \uac00\ub2a5\ud569\ub2c8\ub2e4.\n\n\u25b6\uc560\uc644,\ub300\ucd9c \ubd88\uac00\ud569\ub2c8\ub2e4.\n\n\u25b6\uc8fc\ud0dd\uc784\ub300\uc0ac\uc5c5\uc790 \uac00\uc785\ub418\uc5b4 \uc788\uace0 \ubcf4\uc99d\ubcf4\ud5d8 \uac00\uc785\uac00\ub2a5\ud569\ub2c8\ub2e4",
            "floor_label": "4",
            "has_parking": true,
            "approve_date": "2017\ub1442\uc6d428\uc77c",
            "has_elevator": true,
            "service_type": "\ube4c\ub77c",
            "nearby_places": [
                {
                    "type": "\uc9c0\ud558\ucca0\uc5ed",
                    "distance_m": 400,
                    "travel_mode": "foot",
                    "travel_seconds": 360
                },
                {
                    "type": "\uc138\ud0c1\uc18c",
                    "distance_m": 117,
                    "travel_mode": "foot",
                    "travel_seconds": 105
                }
            ],
            "parking_count": 1,
            "property_type": "villa",
            "bathroom_count": 1,
            "building_floor": 6,
            "deposit_manwon": 23000,
            "residence_type": "\uadf8\uc678",
            "room_type_code": "04",
            "manage_cost_krw": 120000,
            "sales_type_code": "jeonse",
            "direction_criterion": "\uc548\ubc29",
            "manage_cost_excludes": [
                {
                    "code": "01",
                    "name": "\uc804\uae30"
                },
                {
                    "code": "02",
                    "name": "\uac00\uc2a4"
                },
                {
                    "code": "03",
                    "name": "\uc218\ub3c4"
                },
                {
                    "code": "06",
                    "name": "\ub09c\ubc29"
                },
                {
                    "code": "08",
                    "name": "\uae30\ud0c0 \uad00\ub9ac\ube44"
                }
            ],
            "manage_cost_includes": [
                {
                    "code": "07",
                    "name": "\uc77c\ubc18(\uacf5\uc6a9) \uad00\ub9ac\ube44"
                },
                {
                    "code": "04",
                    "name": "\uc778\ud130\ub137"
                },
                {
                    "code": "05",
                    "name": "TV"
                }
            ],
            "residence_type_description": "\uacf5\ub3d9\uc8fc\ud0dd"
        }
    },
    "meta": {
        "billable": true,
        "endpoint_family": "listing_detail"
    },
    "success": true
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | The id is missing or not a positive integer. No upstream request is made. This response is not billable. |
| 404 | Not Found | No listing with this id exists on Zigbang. This response is not billable. |
| 503 | 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. |

## More Scrappa resources

- [API documentation](https://scrappa.co/docs)
- [Full LLM-readable API reference](https://scrappa.co/llms-full.txt)
- [OpenAPI specification](https://scrappa.co/docs/api.json)
- [Pricing](https://scrappa.co/pricing)