> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cometly.com/llms.txt
> Use this file to discover all available pages before exploring further.

# query_contacts_aggregated

> Aggregated count / group-by over contacts (people), pinned to profile-mode aggregation.

Same query plumbing as `query_ad_metrics`, but pinned to `query_mode: profile` so the row is "one per contact" rather than "one per event".

## When to use

* "How many contacts converted from LinkedIn Ads last month?"
* "Count of contacts by country with at least one purchase."
* "Distribution of contacts by device type."

For per-contact data, use [`list_contacts`](/mcp/tools/list-contacts) or [`get_contact`](/mcp/tools/get-contact). For events, use [`query_events_aggregated`](/mcp/tools/query-events-aggregated).

## Parameters

Same shape as `query_ad_metrics`. `query_mode` is forced to `profile`.

## Output

CSV with one row per group combination:

```csv theme={null}
country,purchase,gross_revenue
US,412,38420.50
CA,98,8920.10
UK,73,5510.40
```