# 591 Sale Listing API Documentation

<p><strong>591 Sale Listing API</strong> returns one property for sale. It adds to the search fields: map position (<code>lat</code>, <code>lng</code>), the registered area breakdown in ping (total, main, accessory, shared, land, parking), the public ratio, management fee with period, parking, fitment, fixtures and home tools, traffic and daily-life text, legal use, community, all large photos, the description and the agency name. Phone numbers, LINE ids and e-mail addresses are removed. A listing that no longer exists answers 404 and is not billed. Unofficial: Scrappa is not affiliated with 591. Chinese text stays as 591 returns it; numeric fields are parsed next to it, and a value 591 does not give is null, never 0. Failed requests are not billable.</p>

- **Documentation:** [https://scrappa.co/docs/591-api/house591_sale_listing](https://scrappa.co/docs/591-api/house591_sale_listing)
- **API group:** 591 House API
- **Endpoint:** `GET https://scrappa.co/api/591/sale/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` | string | Yes | Listing id from sale search, with or without the leading S. Example: S21096373. |

## Example response

```json
{
    "data": {
        "id": "S21096373",
        "lat": 25.0331142,
        "lng": 121.5314932,
        "url": "https://sale.591.com.tw/home/house/detail/2/21096373.html",
        "kind": 9,
        "tags": [
            "AI\u56de\u8986",
            "\u5f71\u7247\u8cde\u5c4b",
            "\u660e\u661f\u5b78\u5340",
            "\u8fd1\u6377\u904b"
        ],
        "floor": 5,
        "halls": 2,
        "rooms": 2,
        "title": "\u2b50\ufe0f\u958b\u50f9\u5c31\u662f\u884c\u60c5\u2b50\ufe0f\u7368\u5bb6\u89aa\u53cb\u5c08\u4efb\u5927\u5b89\u6c38\u5eb7\u5169\u623f\u96d9\u8eca\u7a00\u6709\u91cb\u51fa",
        "photos": [
            "https://img1.591.com.tw/house/2026/10/19/179240012476085802.jpg!1000x.water2.jpg",
            "https://img2.591.com.tw/house/2026/10/19/179240012463710701.jpg!1000x.water2.jpg"
        ],
        "region": "\u53f0\u5317\u5e02",
        "street": "\u6c38\u5eb7\u8857",
        "address": "\u53f0\u5317\u5e02\u5927\u5b89\u5340\u6c38\u5eb7\u8857",
        "fitment": "\u4e2d\u6a94\u88dd\u6f62",
        "parking": {
            "type": "\u6a5f\u68b0\u5f0f\uff0c\u5df2\u542b\u552e\u91d1\u5167",
            "description": "9.27\u576a\uff0c\u6a5f\u68b0\u5f0f\uff0c\u5df2\u542b\u552e\u91d1\u5167",
            "has_parking": true
        },
        "section": "\u5927\u5b89\u5340",
        "fixtures": [
            "\u71b1\u6c34\u5668",
            "\u5929\u7136\u74e6\u65af",
            "\u96fb\u8996",
            "\u51b0\u7bb1"
        ],
        "age_years": 12,
        "area_ping": 53.44,
        "bathrooms": 2,
        "community": {
            "id": 6788,
            "name": "\u5927\u5b89\u6c38\u5eb7"
        },
        "kind_name": "\u4f4f\u5b85",
        "legal_use": "\u4f4f\u5bb6\u7528",
        "posted_at": "2026-10-17T08:38:34+00:00",
        "region_id": 1,
        "floor_text": "5F/9F",
        "home_tools": [
            "\u684c\u5b50",
            "\u6905\u5b50",
            "\u8863\u6ac3"
        ],
        "owner_type": "agent",
        "price_text": "6,999\u842c\u5143",
        "section_id": 5,
        "shape_name": "\u96fb\u68af\u5927\u6a13",
        "agency_name": "\u701a\u76db\u4e0d\u52d5\u7522\u6709\u9650\u516c\u53f8",
        "description": "\u26a0\ufe0f\u56e0\u7121\u6cd5\u96a8\u6642\u63a5\u6536\u8a0a\u606f \u8acb\u76f4\u63a5\u96fb\u8a71\u9810\u7d04\u770b\u5c4b\u54e6\u26a0\ufe0f\u3010\u51fa\u552e\u6587\u3011 \u7368\u5bb6\u660e\u661f\u5b78\u5340\u7a00\u6709\u91cb\u51fa\ud83d\udd25\u3010\u6848\u540d\u3011\uff1a\u2728\u958b\u50f9\u53ca\u884c\u60c5\u5927\u5b89\u6c38\u5eb7\u7a00\u67092\u623f\u91cb\u51fa\u5e36\u96d9\u8eca\u4f4d\u2728\u3010\u5730\u9ede\u3011\uff1a\u53f0\u5317\u5e02\u5927\u5b89\u5340\u6c38\u5eb7\u8857\u3010\u985e\u578b\u3011\uff1a\u96fb\u68af\u83ef\u590f\u3010\u7e3d\u50f9\u3011\uff1a6999\u842c\u3010\u576a\u6578\u3011\uff1a53.44\u576a\uff08\u542b\u8eca\uff09\u3010\u6a13\u5c64\u3011\uff1a5F/9F\u3010\u5c4b\u9f61\u3011\uff1a12\u5e74\u3010\u683c\u5c40\u3011\uff1a2\u623f2\u5ef32\u885b2\u967d\u53f0\u3010\u7ba1\u7406\u8cbb\u3011\uff1a42135\u5143/\u2026",
        "layout_text": "2\u623f2\u5ef32\u885b",
        "living_text": "\u8fd1\u4fbf\u5229\u5546\u5e97\uff1b\u767e\u8ca8\u516c\u53f8\uff1b\u516c\u5712\u7da0\u5730\uff1b\u5b78\u6821",
        "price_value": 69990000,
        "total_floors": 9,
        "traffic_text": "\u8fd1\u6771\u9580\u6377\u904b\u7ad9",
        "mortgage_hint": "\u9996\u4ed8\u7d041400\u842c\uff0c\u6708\u9084\u6b3e175,241\u5143",
        "main_area_ping": 22.37,
        "management_fee": {
            "text": "42135\u5143/\u5b63\u5ea6",
            "value": 42135
        },
        "unit_price_per_ping": 1423800,
        "public_ratio_percent": 38,
        "registered_area_breakdown": {
            "land_ping": null,
            "main_ping": 22.37,
            "total_ping": 53.44,
            "shared_ping": 16.97,
            "parking_ping": 9.27,
            "accessory_ping": 4.83
        }
    },
    "meta": {
        "billable": true,
        "endpoint_family": "sale_listing"
    },
    "success": true
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | A required parameter is missing or a value or combination is not allowed. This response is not billable. |
| 404 | Not Found | The listing does not exist or was taken down. This response is not billable. |
| 503 | Upstream Unavailable | 591 could not be reached or returned data that does not match the request. This response is not billable and is retryable. |

## 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)