# LankaPropertyWeb Listing Details API Documentation

Scrappa's `GET /api/lankapropertyweb/listing` returns the full record of one LankaPropertyWeb listing as structured JSON.

## What you get

`title`, `property_type`, `price`, `price_label`, `price_period`, `alternative_price` (the dollar price when the site shows one), `price_per_sqft`, `bedrooms`, `bathrooms`, `floor_area`, `land_size`, `floors`, `parking_spaces`, `furnishing`, `availability`, `construction_status`, `reference`, and for land `offered_for`, `land_shape`, `road_frontage` and `road_width`. `overview` lists every label and value of the site's overview table. You also get the full `description` as plain text, `features`, `address`, `coordinates`, the full `images` gallery, `posted` and the `agent` with the agency link.

## Type is required

Take `id` and `type` from a search result. The site keeps sale, rent and land listings in separate sections, so a wrong `type` returns `404`, which is never billed.

## Privacy

Phone numbers and WhatsApp numbers are never returned.

## Notes

A field the site does not state is `null`. A price on request is `null`.

- **Documentation:** [https://scrappa.co/docs/lankapropertyweb-api/lankapropertyweb_listing](https://scrappa.co/docs/lankapropertyweb-api/lankapropertyweb_listing)
- **API group:** LankaPropertyWeb API
- **Endpoint:** `GET https://scrappa.co/api/lankapropertyweb/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 | Listing id from search, for example 5507299. |
| `type` | string | Yes | sale, rent or land. Take it from the search result. |

## Example request

```bash
#!/bin/bash

curl -X GET \
    -H "x-api-key: YOUR_API_KEY_HERE" \
    "https://scrappa.co/api/lankapropertyweb/listing?id=5507299&type=sale"
```

## Example response

```json
{
    "success": true,
    "data": {
        "id": "5507299",
        "type": "sale",
        "url": "https://www.lankapropertyweb.com/sale/property_details-5507299.html",
        "title": "3br Brand New Canterbury Golf Apartment For Sale At Kahathuduwa",
        "property_type": "Apartment",
        "price": 27000000,
        "price_label": "Rs. 27,000,000",
        "price_period": null,
        "price_qualifier": null,
        "currency": "LKR",
        "alternative_price": null,
        "price_per_sqft": 28541,
        "bedrooms": 3,
        "bathrooms": 2,
        "floor_area": {
            "value": 946,
            "unit": "sqft"
        },
        "land_size": null,
        "availability": "Available Now",
        "construction_status": "Ready to move in",
        "reference": "SA 1297",
        "overview": [
            {
                "label": "Property Type",
                "value": "Apartment"
            },
            {
                "label": "Bedrooms",
                "value": "3"
            }
        ],
        "description": "Our Reference No:- SA 1297\n(Please quote this reference number when inquiring)",
        "features": [],
        "address": {
            "text": "Kahathuduwa"
        },
        "coordinates": {
            "latitude": 6.769539,
            "longitude": 80.010597
        },
        "images": [
            {
                "url": "https://www.lankapropertyweb.com/pics/5507299/5507299_1688647675_4007.jpeg"
            }
        ],
        "posted": "68 days ago",
        "agent": {
            "id": "17540",
            "name": "Bimsara Real Estate",
            "type": "Agent",
            "agency": {
                "slug": "bimsara-real-estate-5353483",
                "id": 5353483,
                "url": "https://www.lankapropertyweb.com/agents/bimsara-real-estate-5353483"
            }
        }
    },
    "meta": {
        "endpoint_family": "listing",
        "billable": true
    }
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 404 | Not Found | No LankaPropertyWeb listing has that id in the requested section. Check the id and the type. (`NOT_FOUND`). Non-billable. |
| 422 | Validation Error | A query parameter is missing, unknown or unusable. Unknown parameters and unknown values are rejected before any lookup, never ignored. Non-billable. |
| 503 | Upstream Unavailable | LankaPropertyWeb could not be reached after retries, answered with an error or changed its format (`UPSTREAM_UNAVAILABLE`). Retryable and never billed. Clients are never rate limited. |

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