Properties

The Properties endpoints let you retrieve detailed property data by ID, address lookup, or filtered search.

Get a property by ID

GET /v1/properties/{id}

Returns a single property by its Straply ID.

Path parameters

Parameter	Type	Description
`id`	string	The Straply property ID (e.g., `stp_a3f7c2e91b4d`)

Example request

curl https://api.straply.com/v1/properties/stp_a3f7c2e91b4d \
  -H "Authorization: Bearer stp_live_YOUR_KEY"

Example response

{
  "data": {
    "id": "stp_a3f7c2e91b4d",
    "status": "forSale",
    "listPrice": 1850000,
    "address": {
      "streetAddress": "742 Evergreen Terrace",
      "city": "Beverly Hills",
      "state": "CA",
      "zipCode": "90210"
    },
    "bedroomsTotal": 4,
    "bathroomsTotal": 3.5,
    "livingArea": 3200,
    "lotSize": 8500,
    "yearBuilt": 1985,
    "propertyType": "singleFamily",
    "daysOnMarket": 12,
    "priceHistory": [
      {
        "date": "2026-02-15",
        "event": "listed",
        "price": 1850000,
        "source": "MLS"
      }
    ],
    "taxHistory": [
      {
        "year": 2025,
        "taxPaid": 18200,
        "assessedValue": 1620000
      }
    ],
    "scores": {
      "walkability": 82,
      "transit": 65,
      "bike": 71
    },
    "coordinates": {
      "latitude": 34.0901,
      "longitude": -118.4065
    },
    "lastUpdated": "2026-03-09T08:00:00Z"
  }
}

Look up a property by address

GET /v1/properties/lookup

Find a property using its street address. Returns an exact match or a 404 if no match is found.

Query parameters

Parameter	Type	Description
`streetAddress`	string	Required. Street address (e.g., `742 Evergreen Terrace`)
`city`	string	Required. City name
`state`	string	Required. Two-letter state code (e.g., `CA`)
`zipCode`	string	Five-digit ZIP code

Example request

curl "https://api.straply.com/v1/properties/lookup?streetAddress=742+Evergreen+Terrace&city=Beverly+Hills&state=CA" \
  -H "Authorization: Bearer stp_live_YOUR_KEY"

Example response

{
  "data": {
    "id": "stp_a3f7c2e91b4d",
    "status": "forSale",
    "listPrice": 1850000,
    "address": {
      "streetAddress": "742 Evergreen Terrace",
      "city": "Beverly Hills",
      "state": "CA",
      "zipCode": "90210"
    },
    "bedroomsTotal": 4,
    "bathroomsTotal": 3.5,
    "livingArea": 3200,
    "lastUpdated": "2026-03-09T08:00:00Z"
  }
}

Search properties

GET /v1/properties

Search for properties with filters. Returns paginated results.

Query parameters

Parameter	Type	Description
`zipCode`	string	Filter by ZIP code
`city`	string	Filter by city name
`state`	string	Filter by two-letter state code
`status`	string	Filter by status: `forSale`, `recentlySold`, `forRent`, `offMarket`
`propertyType`	string	Filter by type: `singleFamily`, `condo`, `townhouse`, `multiFamily`, `land`
`minPrice`	integer	Minimum list price
`maxPrice`	integer	Maximum list price
`minBeds`	integer	Minimum bedrooms
`maxBeds`	integer	Maximum bedrooms
`minBaths`	number	Minimum bathrooms
`minSqft`	integer	Minimum living area in square feet
`maxSqft`	integer	Maximum living area in square feet
`minYearBuilt`	integer	Minimum year built
`maxDaysOnMarket`	integer	Maximum days on market
`limit`	integer	Results per page. Max varies by plan (see below)
`offset`	integer	Number of results to skip
`sort`	string	Sort field: `listPrice`, `daysOnMarket`, `livingArea`, `lastUpdated`
`order`	string	Sort order: `asc` or `desc`

Results per page by plan

The maximum number of results returned per request depends on your plan:

Plan	Default `limit`	Max `limit`
Free	10	25
Developer	25	100
Pro	50	250
Enterprise	100	1,000

Example request

curl "https://api.straply.com/v1/properties?zipCode=90210&status=forSale&minBeds=3&maxPrice=2000000&sort=listPrice&order=asc" \
  -H "Authorization: Bearer stp_live_YOUR_KEY"

Example response

{
  "meta": {
    "total": 47,
    "limit": 25,
    "offset": 0
  },
  "data": [
    {
      "id": "stp_a3f7c2e91b4d",
      "status": "forSale",
      "listPrice": 1850000,
      "address": {
        "streetAddress": "742 Evergreen Terrace",
        "city": "Beverly Hills",
        "state": "CA",
        "zipCode": "90210"
      },
      "bedroomsTotal": 4,
      "bathroomsTotal": 3.5,
      "livingArea": 3200,
      "daysOnMarket": 12,
      "lastUpdated": "2026-03-09T08:00:00Z"
    }
  ]
}

Pagination

Use limit and offset to paginate through results. The meta.total field tells you the total number of matching properties.

# Page 1
curl "https://api.straply.com/v1/properties?zipCode=90210&limit=25&offset=0" \
  -H "Authorization: Bearer stp_live_YOUR_KEY"

# Page 2
curl "https://api.straply.com/v1/properties?zipCode=90210&limit=25&offset=25" \
  -H "Authorization: Bearer stp_live_YOUR_KEY"