--- title: "Property24 API: JSON data, 3 endpoints, 1 credit per call" description: "Property24 API for South African houses, apartments, farms and commercial property for sale or rent, and listings as JSON. 1 credit per successful call." url: https://perceptlayer.com/apis/property24 --- [APIs](https://perceptlayer.com/apis) / [Real estate](https://perceptlayer.com/verticals/real-estate) / Property24 1 credit per call 3 endpoints 14 datapoints # Property24 API Property24 API for South African houses, apartments, farms and commercial property for sale or rent, and listings as JSON. 1 credit per successful call. [Get a free API key](https://perceptlayer.com/signup) Run it below Property24 GET /v1/property24/search?deal\_type=sale&location\_id=432&location\_type=2&min\_bedrooms=2&sort=price\_low ``` { "success": true, "page": 1, "deal_type": "sale", "location": { "id": 432, "type": 2, "type_label": "city", "name": "Cape Town" }, "total_filtered_results": 2492, "total_pages": 125, "filtered_out": 0, "results": [ { "listing_id": "117152359", "path": "/for-sale/zonnebloem/cape-town/western-cape/10166/117152359", "url": "https://www.property24.com/for-sale/zonnebloem/cape-town/western-cape/10166/117152359", "deal_type": "sale", "title": "3 Bedroom Apartment / flat for sale in Zonnebloem - Cape Town", "price": 21000, "price_text": "R 21 000", "location": "Zonnebloem", "description": "- 3 Bedroom apartment on the edgy to in City Bowl - Available from 1 May 2026 - ...", "bedrooms": 3, "bathrooms": 1, "parking_spaces": 1, "floor_size_m2": 75, "images": [ "https://images.prop24.com/378206824/Crop600x400" ] }, { "listing_id": "117605406", "path": "/for-sale/philippi/cape-town/western-cape/8818/117605406", "url": "https://www.property24.com/for-sale/philippi/cape-town/western-cape/8818/117605406", "deal_type": "sale", "title": "2 Bedroom House for sale in Philippi - Cape Town", "price": 230000, "price_text": "R 230 000", "location": "Philippi", "description": "House for sale in Heinz park Philippi, Cape Town. This property features two generously sized bedrooms, perfect for a small family or ...", "bedrooms": 2, "bathrooms": 1, "images": [ "https://images.prop24.com/386285250/Crop600x400" ], "agency": { "id": 35333, "slug": "exp-south-africa", "name": "EXP South Africa", "logo": "https://images.prop24.com/341773167/Ensure264x153" }, "ribbons": [ "Sold" ] }, { "listing_id": "114632308", "path": "/for-sale/philippi/cape-town/western-cape/8818/114632308", "url": "https://www.property24.com/for-sale/philippi/cape-town/western-cape/8818/114632308", "deal_type": "sale", "title": "2 Bedroom House for sale in Philippi - Cape Town", "price": 250000, "price_text": "R 250 000", "location": "Philippi", "description": "We are happy to introduce this 2bedroom house to the market in Phillipi Browns Farm. This property consists of 2bedrooms, open plan ...", "bedrooms": 2, "bathrooms": 1, "erf_size_m2": 176, "images": [ "https://images.prop24.com/390144224/Crop600x400" ], "agency": { "id": 32298, "slug": "sizwe-mlungwana-properties", "name": "Sizwe Mlungwana Properties", "logo": "https://images.prop24.com/200827919/Ensure264x153" }, "ribbons": [ "Reduced" ] } ], "meta": { "request_id": "req_93da6e24926a41ebb912ed1a92117bca", "credits_charged": 1, "credits_remaining": 1825 } } ``` 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. | # | listing\_id string | path string | url url | deal\_type string | title string | price integer | price\_text string | location string | description string | bedrooms integer | bathrooms integer | parking\_spaces number | floor\_size\_m2 number | images string\[\] | | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | 1 | 117152359 | /for-sale/zonnebloem/cape-town/western-cape/10166/117152359 | https://www.property24.com/for-sale/zonnebloem/cape-town/western-cape/10166/117152359 | sale | 3 Bedroom Apartment / flat for sale in Zonnebloem - Cape Town | 21000 | R 21 000 | Zonnebloem | \- 3 Bedroom apartment on the edgy to in City Bowl - Available from 1 May 2026 - ... | 3 | 1 | 1 | 75 | \[1 item\] | | 2 | 117605406 | /for-sale/philippi/cape-town/western-cape/8818/117605406 | https://www.property24.com/for-sale/philippi/cape-town/western-cape/8818/117605406 | sale | 2 Bedroom House for sale in Philippi - Cape Town | 230000 | R 230 000 | Philippi | House for sale in Heinz park Philippi, Cape Town. This property features two generously sized bedrooms, perfect for a small family or ... | 2 | 1 | — | — | \[1 item\] | | 3 | 114632308 | /for-sale/philippi/cape-town/western-cape/8818/114632308 | https://www.property24.com/for-sale/philippi/cape-town/western-cape/8818/114632308 | sale | 2 Bedroom House for sale in Philippi - Cape Town | 250000 | R 250 000 | Philippi | We are happy to introduce this 2bedroom house to the market in Phillipi Browns Farm. This property consists of 2bedrooms, open plan ... | 2 | 1 | — | — | \[1 item\] | Recorded from our API · 3 items shown · 14 datapoints per item GET /v1/property24/search?deal\_type=sale&location\_id=432&location\_type=2&min\_bedrooms=2&sort=price\_low 14 datapoints ### Identity - listing\_id string - title string ### Contact - url url ### Location - location string ### Reputation - images string\[\] ### Price - deal\_type string - price integer - price\_text string ### Other - path string - description string - bedrooms integer - bathrooms integer - parking\_spaces number - floor\_size\_m2 number Playground ## Run this API cURL shell ``` curl "https://api.perceptlayer.com/v1/property24/search?deal_type=sale&location_id=432&location_type=2&min_bedrooms=2&sort=price_low" \ -H "X-API-Key: $API_KEY" ``` Property24 · 3 endpoints ## Endpoints Every endpoint takes the same key. Open one for its parameters and an example request. | Endpoint | Required parameters | Cost | | --- | --- | --- | | [GET `/v1/property24/listing`](https://perceptlayer.com/apis/property24/listing) | `path` +1 optional | 1 credit | | [GET `/v1/property24/locations-autocomplete`](https://perceptlayer.com/apis/property24/locations-autocomplete) | `q` | 1 credit | | [GET `/v1/property24/search`](https://perceptlayer.com/apis/property24/search) | `location_id` `location_type` +8 optional | 1 credit | Overview ## About the Property24 API ## What you can get The Property24 API returns Property24 property data as JSON through 3 endpoints. - **Search:** `search` takes a `location_id` and a `location_type` (1, 2, 4, 5 or 13), with `deal_type` (sale or rent), `property_type` (house, apartment, townhouse, vacant\_land, farm, commercial or industrial), `min_price`, `max_price`, `min_bedrooms`, `min_bathrooms`, `sort` (newest, price\_low or price\_high) and `page`. - **Listings:** `listing` takes a `path`, with `listing_id`. - **Locations:** `locations-autocomplete` takes a `q`. The recorded `search` for homes for sale in location 432, type 2 (the city of Cape Town), with at least two bedrooms and sorted by `price_low`, returns `results` with `listing_id`, `path`, `url`, `deal_type`, `title`, `price`, `price_text`, `location`, `description`, `bedrooms`, `bathrooms`, `parking_spaces`, `floor_size_m2` and `images`. It also returns `location` (with `id`, `type`, `type_label` and `name`), `total_filtered_results` (2,492), `total_pages` and `page`. ## How a call works Search a city: `GET /v1/property24/search?deal_type=sale&location_id=432&location_type=2&min_bedrooms=2&sort=price_low` with your key in the `X-API-Key` header. Each result's `path` is what `listing` takes. Look up a place by name with `locations-autocomplete`. 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 asking prices in Cape Town or another South African city `Use the Property24 API to track asking prices in Cape Town or another South African city` ### Compare price per \`floor\_size\_m2\` across suburbs `` Use the Property24 API to compare price per `floor_size_m2` across suburbs `` ### Watch rentals with \`deal\_type=rent\` `` Use the Property24 API to watch rentals with `deal_type=rent` `` ### Follow farms, vacant land or commercial property by \`property\_type\` `` Use the Property24 API to follow farms, vacant land or commercial property by `property_type` `` FAQ ## Questions **Do I need a Property24 account?** No. You call this Property24 API with your Perceptlayer key in the \`X-API-Key\` header, with no Property24 login. **How much does the Property24 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. **What are location\_id and location\_type?** Every search needs both. Look a place up with \`locations-autocomplete\`; the search response echoes the \`location\` with a \`type\_label\`, such as city for type 2. **Should I build a Property24 scraper instead?** You can, but a Property24 scraper is code you maintain: page changes break it, requests get blocked, and Property24's terms govern how you collect data. The Property24 API gives you 3 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 Property24 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)