Agent-readable docs index: /llms.txt. Full docs in one file: /llms-full.txt. Download /docs.zip to grep all markdown files locally.

Count Properties

Returns the total number of properties and people matching a set of filters. Use the same filters, anchor, and contact_audience parameters as Search Properties.

Body Parameters

body locationsarray
Array of location objects defining where to search. Required unless filters or protocol filters are provided (max 15). Locations use OR logic.
Location object properties
body typestringrequired
Location type: state, county, city, zip_code, radius, or polygon.
body codestring
Location identifier. Required for state (2-letter abbreviation), county (5-digit FIPS code), city (place ID), and zip_code (5-digit ZIP).
body latitudenumber
Center point latitude. Required for radius.
body longitudenumber
Center point longitude. Required for radius.
body radius_milesnumber
Search radius in miles. Required for radius.
body coordinatesarray
Array of [longitude, latitude] pairs defining the boundary. Required for polygon (minimum 3 points).
body filtersarray
Array of filter objects. Required unless locations or protocol filters are provided. You can mix property filters (source_type=properties) and people filters (source_type=people).
Filter object properties
body filter_idstringrequired
The filter slug from the List Filters endpoint (e.g., estimated_value, property_type_id).
body operatorstring
One of the filter's allowed_operators. See Filter Values for all operators by type. Optional for BOOLEAN filters — automatically defaults to is_boolean.
body valueanyrequired
The filter value. Shape depends on the operator — can be a number, string, boolean, array, or object. See Filter Values.
body include_listsobject
Restrict counts to property list IDs, for example { "property_list_ids": [123] }.
body exclude_listsobject
Exclude property list IDs, for example { "property_list_ids": [456] }.
body exclude_previously_exportedboolean | object
Exclude records already exported by your organization.
body anchorstringdefault: properties
Controls which entity is counted as total_results.
Use properties to count matching properties. Use people to count matching people; this requires contact_audience.
body contact_audiencestring
Which contacts to count. Required when anchor is people, optional when properties.
Options: owners, owners_and_family, renters, residents

Response Fields

FieldTypeDescription
total_propertiesintegerNumber of properties matching the filters
total_peopleintegerNumber of people matching the filters and contact_audience
total_resultsintegerEquals total_properties when anchor is properties, or total_people when anchor is people

Notes

  • The same filter validation rules apply as Search Properties.
  • contact_audience is required when anchor is "people" and optional when anchor is "properties".
Request example
curl -X POST "https://api.v2.dealmachine.com/v1/properties/search/count" \
  -H "Authorization: Bearer dm_sk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "locations": [
      { "type": "state", "code": "TX" }
    ],
    "anchor": "properties",
    "contact_audience": "owners",
    "filters": [
      {
        "filter_id": "estimated_value",
        "operator": "range",
        "value": { "min": 200000, "max": 600000 }
      },
      {
        "filter_id": "has_absentee_owners",
        "value": true
      }
    ]
  }'
Response example
{
  "total_properties": 1847,
  "total_people": 2134,
  "total_results": 1847
}
DealMachine API
Powered byHolocron