--- title: "LankaPropertyWeb API: 5 endpoints, 1 credit per call" description: "LankaPropertyWeb API for Sri Lankan houses, apartments and land for sale or rent, listing details and agents as JSON. 1 credit per successful call." url: https://perceptlayer.com/apis/lankapropertyweb --- [APIs](https://perceptlayer.com/apis) / [Real estate](https://perceptlayer.com/verticals/real-estate) / LankaPropertyWeb 1 credit per call 5 endpoints 24 datapoints # LankaPropertyWeb API LankaPropertyWeb API for Sri Lankan houses, apartments and land for sale or rent, listing details and agents as JSON. 1 credit per successful call. [Get a free API key](https://perceptlayer.com/signup) Run it below LankaPropertyWeb GET /v1/lankapropertyweb/search?type=sale&location=Colombo+7&property\_type=Apartment&max\_price=100000000&min\_bedrooms=2 ``` { "success": true, "data": { "items": [ { "id": "5903513", "type": "sale", "property_type": "Apartment", "title": "2 Bedroom Apartment for Sale - Thurstan 42 - Colombo 07 | 52 Million (EM053VE)", "seo_title": "2 Bedroom Apartment for sale in Colombo 7 for Rs. 52M Total", "description": "2 Bedroom Apartment for Sale Thurstan 42 Colombo 07 | 52 Million (EM053VE) Property Details: Property Type:...", "price": 52000000, "price_label": "Rs. 52M", "currency": "LKR", "price_per_sqft": 88737, "bedrooms": 2, "bathrooms": 1, "floor_area": { "value": 586, "unit": "sqft" }, "address": { "area": "Colombo 7", "city": "Colombo 7", "main_city": "Colombo", "region": "Colombo All" }, "coordinates": { "latitude": 6.911665, "longitude": 79.864571 }, "images": [ { "url": "https://www.lankapropertyweb.com/pics/5903513/5903513_1779274635_2005.jpeg", "thumbnail_url": "https://www.lankapropertyweb.com/pics/5903513/thumb_5903513_1779274635_2005.jpeg", "caption": "Living Room" } ], "image_count": 1, "has_video": false, "has_360_view": false, "url": "https://www.lankapropertyweb.com/sale/property_details-5903513.html", "agent": { "id": "167650", "type": "Owner", "logo": "https://www.lankapropertyweb.com/images/pics/profiles/167650_1776507306_3106.png" }, "flags": { "verified": false, "hot_deal": false, "trending": false, "sponsored": false, "new": false, "luxury": true }, "sold": false, "below_average_percent": 15 }, { "id": "5584791", "type": "sale", "property_type": "Apartment", "title": "Apartment for Sale - Windsor Tower - Colombo 07 | LKR 63,000,000", "seo_title": "3 Bedroom Apartment for sale in Colombo 7 for Rs. 63M Total", "description": "3 Bedroom 1520 sqft apartment for sale in Colombo 7 for Rs. 63 million", "price": 63000000, "price_label": "Rs. 63M", "currency": "LKR", "price_per_sqft": 41447, "bedrooms": 3, "bathrooms": 2, "floor_area": { "value": 1520, "unit": "sqft" }, "address": { "area": "Colombo 7", "city": "Colombo 7", "main_city": "Colombo", "region": "Colombo All" }, "coordinates": { "latitude": 6.911665, "longitude": 79.864571 }, "images": [ { "url": "https://www.lankapropertyweb.com/pics/5584791/5584791_1699244216_5975.jpeg", "thumbnail_url": "https://www.lankapropertyweb.com/pics/5584791/thumb_5584791_1699244216_5975.jpeg" }, { "url": "https://www.lankapropertyweb.com/pics/5584791/5584791_1699244214_6146.jpeg", "thumbnail_url": "https://www.lankapropertyweb.com/pics/5584791/thumb_5584791_1699244214_6146.jpeg", "caption": "Bathroom" }, { "url": "https://www.lankapropertyweb.com/pics/5584791/5584791_1699244215_6359.jpeg", "thumbnail_url": "https://www.lankapropertyweb.com/pics/5584791/thumb_5584791_1699244215_6359.jpeg" } ], "image_count": 8, "has_video": false, "has_360_view": false, "url": "https://www.lankapropertyweb.com/sale/property_details-5584791.html", "agent": { "id": "35975", "type": "Owner", "logo": "https://www.lankapropertyweb.com/images/pics/profiles/35975_1781669277_4944.jpeg" }, "flags": { "verified": false, "hot_deal": false, "trending": false, "sponsored": false, "new": false, "luxury": false }, "sold": false, "below_average_percent": -46 }, { "id": "5808999", "type": "sale", "property_type": "Apartment", "title": "Horton Towers - 03 Bedroom Furnished Apartment for Sale in Colombo 07 (A4818)-SOLD", "seo_title": "3 Bedroom Apartment for sale in Colombo 7 for Rs. 65M Total", "description": "Property Code: A4818 Location: Colombo 07 Complex: Horton Towers Type: Furnished Bedroom: 03 Bathroom: 02...", "price": 65000000, "price_label": "Rs. 65M", "currency": "LKR", "price_per_sqft": 40625, "bedrooms": 3, "bathrooms": 2, "floor_area": { "value": 1600, "unit": "sqft" }, "address": { "area": "Colombo 7", "city": "Colombo 7", "main_city": "Colombo", "region": "Colombo All" }, "coordinates": { "latitude": 6.911665, "longitude": 79.864571 }, "images": [ { "url": "https://www.lankapropertyweb.com/pics/5808999/5808999_1756972792_9091.jpeg", "thumbnail_url": "https://www.lankapropertyweb.com/pics/5808999/thumb_5808999_1756972792_9091.jpeg", "caption": "Living Room" }, { "url": "https://www.lankapropertyweb.com/pics/5808999/5808999_1756972802_813.jpeg", "thumbnail_url": "https://www.lankapropertyweb.com/pics/5808999/thumb_5808999_1756972802_813.jpeg", "caption": "Living Room" }, { "url": "https://www.lankapropertyweb.com/pics/5808999/5808999_1756972812_724.jpeg", "thumbnail_url": "https://www.lankapropertyweb.com/pics/5808999/thumb_5808999_1756972812_724.jpeg", "caption": "Living Room" } ], "image_count": 10, "has_video": false, "has_360_view": false, "url": "https://www.lankapropertyweb.com/sale/property_details-5808999.html", "agent": { "id": "162454", "type": "Owner", "logo": "https://www.lankapropertyweb.com/images/pics/profiles/162454/logonew-11.png" }, "flags": { "verified": true, "hot_deal": false, "trending": false, "sponsored": false, "new": false, "luxury": false }, "availability": "SOLD", "sold": true } ], "pagination": { "page": 1, "per_page": 25, "total": 58, "total_pages": 3, "returned": 25, "dropped_by_filter": 0, "has_more": true }, "query": { "type": "sale", "location": "Colombo 7", "property_type": "Apartment", "max_price": "100000000", "min_bedrooms": "2" } }, "meta": { "endpoint_family": "search", "request_id": "req_16e3c6116c8046f2bb155f3cb96ed761", "credits_charged": 1, "credits_remaining": 1849 } } ``` 200 OK JSON X-Credits-Used: 1 Recorded from our API and shortened. Sample data ## What one call returns A recorded run of `search`: the fields and shapes you will get, shortened to 3 items. | # | id string | type string | property\_type string | title string | seo\_title string | description string | price integer | price\_label string | currency string | price\_per\_sqft integer | bedrooms integer | bathrooms integer | floor\_area object | address object | coordinates object | images object\[\] | image\_count integer | has\_video boolean | has\_360\_view boolean | url url | agent object | flags object | sold boolean | below\_average\_percent number | | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | 1 | 5903513 | sale | Apartment | 2 Bedroom Apartment for Sale - Thurstan 42 - Colombo 07 \| 52 Million (EM053VE) | 2 Bedroom Apartment for sale in Colombo 7 for Rs. 52M Total | 2 Bedroom Apartment for Sale Thurstan 42 Colombo 07 \| 52 Million (EM053VE) Property Details: Property Type:... | 52000000 | Rs. 52M | LKR | 88737 | 2 | 1 | {2 fields} | {4 fields} | {2 fields} | \[1 item\] | 1 | false | false | https://www.lankapropertyweb.com/sale/property\_details-5903513.html | {3 fields} | {6 fields} | false | 15 | | 2 | 5584791 | sale | Apartment | Apartment for Sale - Windsor Tower - Colombo 07 \| LKR 63,000,000 | 3 Bedroom Apartment for sale in Colombo 7 for Rs. 63M Total | 3 Bedroom 1520 sqft apartment for sale in Colombo 7 for Rs. 63 million | 63000000 | Rs. 63M | LKR | 41447 | 3 | 2 | {2 fields} | {4 fields} | {2 fields} | \[3 items\] | 8 | false | false | https://www.lankapropertyweb.com/sale/property\_details-5584791.html | {3 fields} | {6 fields} | false | \-46 | | 3 | 5808999 | sale | Apartment | Horton Towers - 03 Bedroom Furnished Apartment for Sale in Colombo 07 (A4818)-SOLD | 3 Bedroom Apartment for sale in Colombo 7 for Rs. 65M Total | Property Code: A4818 Location: Colombo 07 Complex: Horton Towers Type: Furnished Bedroom: 03 Bathroom: 02... | 65000000 | Rs. 65M | LKR | 40625 | 3 | 2 | {2 fields} | {4 fields} | {2 fields} | \[3 items\] | 10 | false | false | https://www.lankapropertyweb.com/sale/property\_details-5808999.html | {3 fields} | {6 fields} | true | — | Recorded from our API · 3 items shown · 24 datapoints per item GET /v1/lankapropertyweb/search?type=sale&location=Colombo+7&property\_type=Apartment&max\_price=100000000&min\_bedrooms=2 24 datapoints ### Identity - id string - type string - property\_type string - title string - seo\_title string ### Contact - url url - agent object ### Location - floor\_area object - address object ### Reputation - images object\[\] - image\_count integer ### Price - price integer - price\_label string - currency string - price\_per\_sqft integer ### Other - description string - bedrooms integer - bathrooms integer - coordinates object - has\_video boolean - has\_360\_view boolean - flags object - sold boolean - below\_average\_percent number Playground ## Run this API cURL shell ``` curl "https://api.perceptlayer.com/v1/lankapropertyweb/search?type=sale&location=Colombo+7&property_type=Apartment&max_price=100000000&min_bedrooms=2" \ -H "X-API-Key: $API_KEY" ``` LankaPropertyWeb · 5 endpoints ## Endpoints Every endpoint takes the same key. Open one for its parameters and an example request. | Endpoint | Required parameters | Cost | | --- | --- | --- | | [GET `/v1/lankapropertyweb/agent`](https://perceptlayer.com/apis/lankapropertyweb/agent) | `slug` +1 optional | 1 credit | | [GET `/v1/lankapropertyweb/agents`](https://perceptlayer.com/apis/lankapropertyweb/agents) | none +2 optional | 1 credit | | [GET `/v1/lankapropertyweb/autocomplete`](https://perceptlayer.com/apis/lankapropertyweb/autocomplete) | `q` | 1 credit | | [GET `/v1/lankapropertyweb/listing`](https://perceptlayer.com/apis/lankapropertyweb/listing) | `id` `type` | 1 credit | | [GET `/v1/lankapropertyweb/search`](https://perceptlayer.com/apis/lankapropertyweb/search) | `type` +11 optional | 1 credit | Overview ## About the LankaPropertyWeb API ## What you can get The LankaPropertyWeb API returns LankaPropertyWeb property data as JSON through 5 endpoints. - **Search:** `search` takes a `type` (sale, rent or land), with `location`, `property_type`, `min_price`, `max_price`, `min_bedrooms`, `min_land`, `max_land`, `min_floor_area`, `max_floor_area`, `keywords` and `page`. - **Listings:** `listing` takes an `id` and a `type` (sale, rent or land). - **Agents:** `agents` takes an `agent_type` (Sales, Rentals, Land, Commercial, Management or Research), with `page`; `agent` takes a `slug`, with `page`. - **Locations:** `autocomplete` takes `q`. The recorded `search` for apartments for sale in Colombo 7 (at least 2 bedrooms, up to 100,000,000) returns a `total` of 58, with `total_pages` and `has_more`. Each item carries `id`, `type`, `property_type`, `title`, `description`, `price`, `price_label`, `currency`, `price_per_sqft`, `bedrooms`, `bathrooms`, `floor_area`, `address`, `coordinates`, `image_count`, `has_video`, `has_360_view`, `url`, `agent`, `sold` and `below_average_percent`. ## How a call works Search a location: `GET /v1/lankapropertyweb/search?type=sale&location=Colombo 7&property_type=Apartment&max_price=100000000&min_bedrooms=2` with your key in the `X-API-Key` header. Each item's `id` and `type` are the two parameters `listing` takes. Every successful call costs 1 credit; failed calls cost nothing. Real estate JSON REST MCP ### More real estate APIs [28Hse](https://perceptlayer.com/apis/28hse) [4zida](https://perceptlayer.com/apis/4zida) [591](https://perceptlayer.com/apis/591-house) [99.co](https://perceptlayer.com/apis/99co) [99acres](https://perceptlayer.com/apis/99acres) [Adondevivir](https://perceptlayer.com/apis/adondevivir) [Apartment List](https://perceptlayer.com/apis/apartment-list) [Apartments.com](https://perceptlayer.com/apis/apartments-com) [Aqar](https://perceptlayer.com/apis/aqar) [Aqarmap](https://perceptlayer.com/apis/aqarmap) [Argenprop](https://perceptlayer.com/apis/argenprop) [athome](https://perceptlayer.com/apis/athome) Use cases ### Track apartment prices in Colombo and across Sri Lanka `Use the LankaPropertyWeb API to track apartment prices in Colombo and across Sri Lanka` ### Compare \`price\_per\_sqft\` between neighbourhoods `` Use the LankaPropertyWeb API to compare `price_per_sqft` between neighbourhoods `` ### Spot listings priced below the area average with \`below\_average\_percent\` `` Use the LankaPropertyWeb API to spot listings priced below the area average with `below_average_percent` `` ### Search land for sale by size with \`type=land\`, \`min\_land\` and \`max\_land\` `` Use the LankaPropertyWeb API to search land for sale by size with `type=land`, `min_land` and `max_land` `` FAQ ## Questions **How much does the LankaPropertyWeb API cost?** Each successful call costs one credit. New accounts get free credits to start, and credit packs bring the price down as you scale. **What format are responses in?** Every endpoint returns JSON, with no HTML parsing on your side. **Do I need a LankaPropertyWeb account?** No. You call this LankaPropertyWeb API with your Perceptlayer key in the \`X-API-Key\` header, with no LankaPropertyWeb login. **Should I build a LankaPropertyWeb scraper instead?** You can, but a LankaPropertyWeb scraper is code you maintain: page changes break it, requests get blocked, and LankaPropertyWeb's terms govern how you collect data. The LankaPropertyWeb API gives you 5 endpoints of named JSON fields for 1 credit per successful call, and failed calls cost nothing. A scraper makes sense only for data these endpoints don't return, so check the response in the playground on this page first. ## Try the LankaPropertyWeb API with 100 free credits No credit card. Failed calls are never billed. [Get a free API key](https://perceptlayer.com/signup) [Read the docs](https://docs.perceptlayer.com)