Skip to main content
POST
/
v1
/
people
/
search
/
count
curl -X POST "https://api.v2.dealmachine.com/v1/people/search/count" \
  -H "Authorization: Bearer dm_sk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "locations": [
      { "type": "state", "code": "TX" }
    ],
    "property_match": "owner",
    "filters": [
      {
        "filter_id": "estimated_value",
        "operator": "greater_than",
        "value": 500000
      },
      {
        "filter_id": "has_phone",
        "value": true
      }
    ]
  }'

{
  "total_people": 412,
  "total_properties": 387,
  "total_results": 412
}
Returns the total number of people and properties matching a set of filters. Use the same filters and property_match parameters as Search People.

​
Body Parameters

​
locations
array
Array of location objects defining where to search. Required unless filters or protocol filters are provided (max 15). Locations use OR logic.
​
filters
array
Array of filter objects. Required unless locations or protocol filters are provided. You can mix people filters (source_type=people) and property filters (source_type=properties).
​
include_lists
object
Restrict counts to people list IDs, for example { "people_list_ids": [123] }.
​
exclude_lists
object
Exclude people list IDs, for example { "people_list_ids": [456] }.
​
exclude_previously_exported
boolean | object
Exclude people already exported by your organization.
​
property_match
string
Required when property filters are present. Defines the person-to-property relationship used to connect people to matching properties. Ignored when only people filters are used.Options: owner, resident, renter
curl -X POST "https://api.v2.dealmachine.com/v1/people/search/count" \
  -H "Authorization: Bearer dm_sk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "locations": [
      { "type": "state", "code": "TX" }
    ],
    "property_match": "owner",
    "filters": [
      {
        "filter_id": "estimated_value",
        "operator": "greater_than",
        "value": 500000
      },
      {
        "filter_id": "has_phone",
        "value": true
      }
    ]
  }'

{
  "total_people": 412,
  "total_properties": 387,
  "total_results": 412
}

​
Response Fields

FieldTypeDescription
total_peopleintegerNumber of people matching the filters
total_propertiesintegerNumber of properties connected via property_match. 0 when no property filters are used.
total_resultsintegerAlways equals total_people for people search

​
Notes

  • The same filter validation rules apply as Search People.
  • property_match is required when any property filter is present, and ignored when only people filters are used.
  • When no property filters are present, total_properties is 0.