Properstar APIproperstar.co.uk ↗

Search for homes for sale across UK cities on Properstar and instantly access detailed property information including prices, photos, bedroom and bathroom counts, square footage, and exact locations. Find your next home with comprehensive listings that show you everything you need to know at a glance.

This API takes change requests — .

Endpoint health

monitored

search_homes

Checks pendingself-healing

Endpoints

Updated

4h ago

This call costs10 credits / call— charged only on success

Try it

city*

City slug for the search URL (e.g. 'cancun', 'playa-del-carmen', 'mexico-city'). Use lowercase with hyphens for multi-word cities.

page

Page number for pagination (1-based).

country

Country slug for the search URL (e.g. 'mexico', 'spain', 'france'). Use lowercase with hyphens.

→ api.parse.bot/scraper/9800404f-6941-420d-99e7-6cb1a6d4cb67/<endpoint>

Ready to send

Fill in the parameters and hit sign in to send to see live response data here.

Call it over HTTPgrab a free API key at signup

curl -X GET 'https://api.parse.bot/scraper/9800404f-6941-420d-99e7-6cb1a6d4cb67/search_homes?city=cancun&country=mexico&page=1' \
  -H 'X-API-Key: $PARSE_API_KEY'

All endpoints · 1 totalmissing one? ·

Search apartments and houses for sale in a specified city. Returns paginated results with property details including price, listing URL, pictures, bedroom/bathroom count, size in square feet, text location, and latitude/longitude coordinates. Each page returns approximately 15-20 listings. Geolocation is fetched from a supplementary API and merged by listing ID; it may be absent for some listings. The Azure WAF JS challenge is solved automatically on each request, adding ~2 seconds latency.

Input

Param	Type	Description
cityrequired	string	City slug for the search URL (e.g. 'cancun', 'playa-del-carmen', 'mexico-city'). Use lowercase with hyphens for multi-word cities.
page	integer	Page number for pagination (1-based).
country	string	Country slug for the search URL (e.g. 'mexico', 'spain', 'france'). Use lowercase with hyphens.

Response

{
  "type": "object",
  "fields": {
    "page": "Current page number",
    "listings": "Array of property listings with id, url, price, location, title, highlights, bedrooms, bathrooms, size_sqft, property_type, pictures, latitude, longitude",
    "total_results": "Total number of matching listings across all pages"
  },
  "sample": {
    "data": {
      "page": 1,
      "listings": [
        {
          "id": 119421149,
          "url": "https://www.properstar.co.uk/listing/119421149",
          "price": "GBP 410,924",
          "title": "House for sale, Isla Blanca 201, 77504 Cancún, Q.R., Mexico (Cancún, Mexico)",
          "bedrooms": 3,
          "latitude": 21.137162,
          "location": "Cancún, Isla Blanca 201, 77504 Cancún, Q.R., Mexico",
          "pictures": [
            "https://files-api.properstar.com/api/v2/files/ba59a512-139b-46b5-9454-68ee4f817740/1?mode=crop&width=512&height=384&format=jpeg"
          ],
          "bathrooms": 4,
          "longitude": -86.828409,
          "size_sqft": 3509,
          "highlights": "House • 3 bed. • 4 bath. • 3509 sq ft",
          "property_type": "House"
        }
      ],
      "total_results": 9101
    },
    "status": "success"
  }
}

About the Properstar API

The Properstar API on Parse exposes 1 endpoint for the publicly available data on properstar.co.uk. Calls return JSON over HTTPS and are billed per successful response.

Pin a release with the API-Snapshot-Version header so canonical updates don't silently change your contract.