Property API

Queries can be as complex or as simple as you need them to be. Queries are passed along as strings in the query parameter using the type:value format.

Queries are space separated key-values. For example, to find all properties with a price between $0 & $800,000 located in Sonoma, the query would look like this:

price:0~800000 city:"Sonoma"

To query multiple cities, postal codes, states or statuses simply add more type:value pairs:

city:"Napa" city:"Sonoma"

Fields:

  • mls_number
  • price (range)
  • postal_code
  • city
  • state
  • status (Active, Sold, Pending or Contingent)
  • property_type (Single Family Residential, Condo/Co-op, Multi-Family (2-4 Unit) or Vacant Land)
  • source

Here's an example request using curl:

curl 'https://api.clearmls.io/properties' \
-G --data-urlencode 'query=city:"Sonoma" price:0~800000' \
-u API_KEY:

Response:

The API response will look similar to this:

  "properties": [
    {
      "postal_code": "94131",
      "mls_number": "455968",
      "sale_type": "PAST SALE",
      "sold_date": "2017-02-15",
      "property_type": "Single Family Residential",
      "address": "564 Valley St",
      "city": "San Francisco",
      "state": "CA",
      "price": 3150000,
      "beds": 4,
      "baths": 3.5,
      "location": "Noe Valley",
      "square_feet": 3064,
      "lot_size": 2848,
      "year_built": 1910,
      "days_on_market": 49,
      "hoa_per_month": 0,
      "status": "Sold",
      "next_open_house_start_time": null,
      "next_open_house_end_time": null,
      "source": "San Francisco MLS",
      "latitude": 37.7442068,
      "longitude": -122.4348571,
      "price_per_square_foot": 1028,
      "description": "Sold: 4 bed, 3.5 bath, 3064 sq. ft. custom home at 564 Valley St, San Francisco, CA 94131 sold for $3,150,000 on Feb 15, 2017. MLS# 455968. Located in the beautiful Noe Valley."
    }
  ]
}

Still need help? Contact Us Contact Us