# Property24 API
South Africa property data from Property24: listings for sale and to rent, new developments, agencies, area market trends and sold prices.
- Page: https://happyendpoint.com/library/property24-api
- RapidAPI: https://rapidapi.com/happyendpoint/api/property241
- RapidAPI host: `property241.p.rapidapi.com`
- MCP: `https://mcp.rapidapi.com` with headers `x-api-host: property241.p.rapidapi.com` and `x-api-key: <your key>`
- Tags: real-estate, south-africa, property-listings, sold-prices, new-developments, africa
## Features

- South African property search for sale and to rent
- New development tracking with unit plans and prices
- Area market trends and recorded sold prices
- Listings in Kenya, Nigeria, Zambia, Botswana, Zimbabwe and Mozambique

## Endpoints (37)

- `GET /status` - Check whether the Property24 API is available.
- `GET /reference-data` - Property types, price and size ladders, listing types and the prime rate - the vocabularies the search filters use.
- `GET /locations` - Find areas by name - provinces, cities, suburbs and named regions - to get the location ids every search takes.
- `GET /location-children` - Drill down the area tree one level (country → provinces → cities → suburbs, or a named region's members) with listing counts.
- `GET /locations-by-ids` - Resolve up to 50 area ids of any kind back to their names, kinds, parents and centre points in one call.
- `GET /location-at-point` - Reverse-geocode a coordinate to the province, city, suburb or extension containing it, with its boundary.
- `GET /aliases` - The named regions (e.g. Atlantic Seaboard, East Rand) with their member suburbs or cities and listing counts.
- `GET /bond-calculation-data` - Prime rate, VAT and the bond, transfer-duty and conveyancing cost brackets for a home-loan and purchase-cost calculator.
- `GET /location-boundary` - The boundary polygon(s) of one province, city, suburb, extension or named region, to draw it on a map.
- `GET /locations-in-polygon` - The provinces, cities or suburbs whose centre lies inside a drawn polygon, with the matching listings each has inside it.
- `GET /travel-time` - Driving distance, time and route between two points (e.g. a listing and a workplace), traffic-aware for a future departure.
- `GET /search` - Search listings for sale or to rent by location, price, rooms, size, type and features, sorted and paged.
- `GET /search-by-polygon` - Search listings inside a polygon drawn on the map, with the same filters, sort and paging as /search.
- `GET /search-by-url` - Run a search from a pasted www.property24.com search-results URL and see how its filters map to /search.
- `GET /listing-details` - The full listing by listing number: description, photos, agents with phone numbers, details table, show days and nearby places.
- `GET /listing-by-url` - The full listing from a pasted www.property24.com listing URL - the same payload as /listing-details.
- `GET /listings-by-ids` - Up to 50 listings by listing number in one call, as listing rows with map positions; unknown numbers are listed separately.
- `GET /listing-by-agency-reference` - Find a listing from an estate agency's own stock reference instead of a listing number.
- `GET /map-listings` - Map pins (single listings and clusters, each with coordinates) for the listings inside a map area that match the filters.
- `GET /suburbs` - The suburbs of an area with how many live listings match the filters in each.
- `GET /development-suggestions` - Find new developments, property developers and areas by name - returns the ids the development search and details take.
- `GET /developments` - Search new developments by location, sale or rental, price range, category and developer, with paging.
- `GET /developments-by-polygon` - Search new developments inside a polygon drawn on the map, with the same filters and paging as /developments.
- `GET /development-details` - Open one new development: unit plans with sizes and prices, photos, facilities, developer and sales contacts.
- `GET /development-by-listing-number` - Find a new development by the P24 listing number shown on its page - returns its search row and development_id.
- `GET /agency-suggestions` - Find estate agencies by name - returns the agency ids /agency-details and the /search agency filter take.
- `GET /agency-details` - Open one estate agency branch: office phone, website, about text and logo; /search?agency_ids= lists its stock.
- `GET /map-developments` - Development pins for a map polygon, clustered by zoom level: sale or rental developments, filtered by kind of unit and price.
- `GET /area-trends` - Market trends for a city or suburb: yearly registered sales with average asking vs sale prices, monthly stock, asking prices by bedrooms and the buyer/seller age profile.
- `GET /sold-price-locations` - Browse the sold-prices index one level down: a province's cities, a city's suburbs or a suburb's streets.
- `GET /sold-price-street` - The recorded addresses of one street or sectional-title scheme, with exact locations and last sold price and year (published as images), 20 a page.
- `GET /sold-price-property` - One recorded property or unit: address, exact location, Deeds legal description and last sold price and year (published as images).
- `GET /country-locations` - Find location ids (counties / provinces, cities, suburbs) in Kenya, Mozambique, Zambia, Botswana, Zimbabwe or Nigeria - the ids the other country endpoints take.
- `GET /country-search` - Search property for sale or to rent in Kenya, Mozambique, Zambia, Botswana, Zimbabwe or Nigeria - country-wide, in one location or in several at once, with filters and sorting.
- `GET /country-listing-details` - Read one listing in Kenya, Mozambique, Zambia, Botswana, Zimbabwe or Nigeria in full - overview, features, photos, agency and agents.
- `GET /country-agencies` - List Kenya's estate agencies - country-wide, in one location or in several at once - with logos, profiles and listing counts.
- `GET /country-developments` - List new developments in Kenya - country-wide, in one location or in several at once - with price ranges and the units on offer.

The Property24 API provides South African real estate data from Property24, the country's largest property portal. It covers property for sale and to rent, new developments, estate agencies, area market trends and sold prices, with additional listings in Kenya, Nigeria, Zambia, Botswana, Zimbabwe and Mozambique.

## Search and data coverage

`/locations` finds provinces, cities, suburbs and named regions by name, and `/location-children`, `/aliases` and `/suburbs` walk the area tree with listing counts. `/reference-data` lists property types, price ladders and the prime rate. `/search` filters by location, price, rooms, size, type and features, with polygon and pasted-URL forms. `/listing-details` returns the description, photos, agents with phone numbers and show days, and `/listings-by-ids` refreshes up to 50 listings in one call.

Development routes search new developments and return unit plans with sizes and prices. Agency routes return branch details. `/area-trends` returns yearly registered sales with asking against sale prices, monthly stock and asking prices by bedrooms. Sold price routes browse recorded sales down to street and property level. `/bond-calculation-data` supplies home loan and purchase cost inputs, and the country routes cover the six other African markets.

## What you can build

- South African property search for sale and to rent
- New development tracking with unit plans and prices
- Area market trends and recorded sold prices
- Listings in Kenya, Nigeria, Zambia, Botswana, Zimbabwe and Mozambique

## Coverage and comparison tips

Prices are in rand for South Africa and in local currency elsewhere, so store the currency with each record. Compare asking prices against the registered sales in `/area-trends` rather than against single sold records. Coverage outside South Africa is lighter, and agency and development routes for other countries focus on Kenya.

## Getting started

Start with `/locations` to discover the identifiers and filter values used by the routes above. Then test a focused request such as `/locations?query=Sea Point` and inspect its JSON response before adding more filters or pagination. The endpoint list below reflects the supplied OpenAPI specification.

Subscribe to the [Property24 API on RapidAPI](https://rapidapi.com/happyendpoint/api/property241) to get your API key and view current plans and request limits. Send your key in the `X-RapidAPI-Key` header and use `X-RapidAPI-Host: property241.p.rapidapi.com` for requests.

## Related data sources

Explore [Rightmove UK API](/library/rightmove-uk) and [Domain.com.au API](/library/domain-com-au-api), or browse the [API library](/library) for other markets and platforms.

## Disclaimer

This API is an independent service built by HappyEndpoint. It is not affiliated with, endorsed, or sponsored by Property24. All data is retrieved from publicly available sources.