---
title: "Properties (Search and Detail)"
method: GET
path: "/properties"
tags: ["Real Estate"]
---

# Properties (Search and Detail)

`GET /properties`

## Request

- Base URL: `https://api.dataporium.io`
- URL: `https://api.dataporium.io/properties`
- Auth: API key in query parameter `apikey`

One endpoint for US homes of every status: for sale, pending, for rent, sold in the last 12 months and off the market. Search a place with filters, or look up one home by property ID or by address.

Search mode: give at least one of zip, city, county or state. With no location at all the whole US is searched from a fixed sample, and the answer is marked approximate: true (counts are estimates). Very large areas are answered the same way. Detail mode: give property_id or address. All other parameters are optional filters. Not available with demo keys.

## Query parameters

- `zip` string
- `city` string
- `county` string
- `state` string
- `status` string
- `price_min` number
- `price_max` number
- `beds_min` integer
- `beds_max` integer
- `baths_min` number
- `baths_max` number
- `sqft_min` integer
- `sqft_max` integer
- `lot_min` integer
- `lot_max` integer
- `year_built_min` integer
- `year_built_max` integer
- `style` string
- `new_construction` boolean
- `hoa_max` number
- `dom_min` integer
- `dom_max` integer
- `true_dom_min` integer
- `true_dom_max` integer
- `listed_within_days` integer
- `price_cut` boolean
- `price_cut_within_days` integer
- `cut_min` number
- `cut_pct_min` number
- `relisted` boolean
- `sold_within_days` integer
- `below_area_ppsf` boolean
- `below_area_ppsf_pct` number
- `sort` string
- `limit` integer
- `offset` integer
- `fields` string
- `with_payment` boolean
- `property_id` string
- `address` string
- `address_matches_only` boolean
- `radius_miles` number
- `nearby_same_beds` boolean
- `nearby_same_style` boolean
- `nearby_sqft_min` integer
- `nearby_sqft_max` integer
- `down_payment_pct` number
- `down_payment_amount` number
- `interest_rate` number
- `loan_term_years` integer
- `property_tax_rate` number
- `insurance_per_year` number
- `hoa_per_month` number
- `pmi_rate_pct` number
- `maintenance_per_year` number

## Response `200`

Successful response (JSON).

- object

## Other responses

- `401`: No API key in the request.
- `403`: The API key is not valid or has expired.

---

[API](https://skmtc.dev/dataporium/apis/dataporium-data-api.md) · [All operations](https://skmtc.dev/dataporium/apis/dataporium-data-api/llms.txt) · [OpenAPI document](https://skmtc.dev/dataporium/apis/dataporium-data-api/revisions/8bc593179dc8?raw)