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

Count People

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

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 people filters (source_type=people) and property filters (source_type=properties).
Filter object properties
body filter_idstringrequired
The filter slug from the List Filters endpoint (e.g., has_phone, estimated_value).
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 people list IDs, for example { "people_list_ids": [123] }.
body exclude_listsobject
Exclude people list IDs, for example { "people_list_ids": [456] }.
body exclude_previously_exportedboolean | object
Exclude people already exported by your organization.
body property_matchstring
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

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.
Request example
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
      }
    ]
  }'
Response example
{
  "total_people": 412,
  "total_properties": 387,
  "total_results": 412
}
DealMachine API
Powered byHolocron