Skip to main content
POST
/
v1
/
properties
/
search
/
count
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
      }
    ]
  }'

{
  "total_properties": 1847,
  "total_people": 2134,
  "total_results": 1847
}
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

​
locations
array
required
Array of location objects defining where to search. At least one location is required (max 15). Locations use OR logic.
​
filters
array
required
Array of filter objects. At least one filter is required. You can mix property filters (source_type=properties) and people filters (source_type=people).
​
anchor
string
default:"properties"
Controls which entity is counted as total_results.
  • properties — total_results reflects the number of matching properties.
  • people — total_results reflects the number of matching people. Requires contact_audience.
​
contact_audience
string
Which contacts to count. Required when anchor is people, optional when properties.Options: owners, owners_and_family, renters, residents
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
      }
    ]
  }'

{
  "total_properties": 1847,
  "total_people": 2134,
  "total_results": 1847
}

​
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".