Get stats
Endpoints
Get stats
Pre-counted totals broken down by columns. Lets you size queries before pulling rows.
GET
Get stats
When you’d use this
Before paying the cost of pulling thousands of rows, peek at the counts. “How many tier-1 leads in Texas?” — this answers it in one cheap call. Perfect for dashboards and filter UIs.Query parameters
| Name | Type | Default | Description |
|---|---|---|---|
group_by | string (optional) | tier,state,match_score | Comma-separated column names to break down counts by. Max 5. |
Cached for 60 seconds. This endpoint is hit a lot, so we cache
it. If you need to-the-second precision, use
/search.Request
Response
groups shows one combination of values plus its count.
So the third row above means: 7,104 leads have tier=1 AND state=CA.
The response includes X-Cache: HIT or X-Cache: MISS so you can
see whether the answer came from the cache.