Sign inGet a free API keyDashboard
Menu

APIs / Real estate / Property24

1 credit per call3 endpoints14 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 keyRun 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 OKJSONX-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_idstringpathstringurlurldeal_typestringtitlestringpriceintegerprice_textstringlocationstringdescriptionstringbedroomsintegerbathroomsintegerparking_spacesnumberfloor_size_m2numberimagesstring[]
1117152359/for-sale/zonnebloem/cape-town/western-cape/10166/117152359https://www.property24.com/for-sale/zonnebloem/cape-town/western-cape/10166/117152359sale3 Bedroom Apartment / flat for sale in Zonnebloem - Cape Town21000R 21 000Zonnebloem- 3 Bedroom apartment on the edgy to in City Bowl - Available from 1 May 2026 - ...31175[1 item]
2117605406/for-sale/philippi/cape-town/western-cape/8818/117605406https://www.property24.com/for-sale/philippi/cape-town/western-cape/8818/117605406sale2 Bedroom House for sale in Philippi - Cape Town230000R 230 000PhilippiHouse for sale in Heinz park Philippi, Cape Town. This property features two generously sized bedrooms, perfect for a small family or ...21——[1 item]
3114632308/for-sale/philippi/cape-town/western-cape/8818/114632308https://www.property24.com/for-sale/philippi/cape-town/western-cape/8818/114632308sale2 Bedroom House for sale in Philippi - Cape Town250000R 250 000PhilippiWe are happy to introduce this 2bedroom house to the market in Phillipi Browns Farm. This property consists of 2bedrooms, open plan ...21——[1 item]

Recorded from our API · 3 items shown · 14 datapoints per itemGET /v1/property24/search?deal_type=sale&location_id=432&location_type=2&min_bedrooms=2&sort=price_low

14 datapoints

Identity

  • listing_idstring
  • titlestring

Contact

  • urlurl

Location

  • locationstring

Reputation

  • imagesstring[]

Price

  • deal_typestring
  • priceinteger
  • price_textstring

Other

  • pathstring
  • descriptionstring
  • bedroomsinteger
  • bathroomsinteger
  • parking_spacesnumber
  • floor_size_m2number

Playground

Run this API

cURLshell
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.

EndpointRequired parametersCost
GET/v1/property24/listing
path+1 optional
1 credit
GET/v1/property24/locations-autocomplete
q
1 credit
GET/v1/property24/search
location_idlocation_type+8 optional
1 credit

Overview

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 estateJSONRESTMCP

More real estate APIs

28Hse4zida59199.co99acresAdondevivirApartment ListApartments.comAqarAqarmapArgenpropathome

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 keyRead the docs