# How to use our Top People API?

## <mark style="color:blue;">Overview</mark>

DeepDAO’s Top People API allows our users to create market segmentations of voters across all DAOs listed on our platforms.

The create\_marketing\_list call is where you start. Use it to create a new market segment of voters based on several criteria:

## <mark style="color:purple;">Selection</mark> <mark style="color:purple;">Criteria</mark>&#x20;

### Categories

Select from the DeepDAO categories those that make sense for your needs. You can select zero or multiple categories. If you select zero categories, we will include voters from all of them.

### Organizations

In addition to categories, you can add voters from certain organizations that make sense for you. You can select zero or multiple organizations. If you select zero organizations, we will include voters from all of them.

### Treasury size

If you select a minimum and / or maximum treasury size, we will include voters only from organizations within this treasury range.

### Governance platforms

You can restrict voters, so that they only voted on certain governance systems. For example you can choose Snapshot (off-chain), or Compound Governance (on-chain) or both, or all of the DeepDAO supported platforms.

### Start date / End date

You can restrict your market segment to people (addresses) who voted only between two dates.

## <mark style="color:purple;">Which addresses are eligible to be in my list?</mark>&#x20;

The list you created is a segment of confirmed voters. Each person (address) included in DeepDAO’s marketing segments, voted at least once in a DAO.&#x20;

The full list of voters, ranked by their Participation Score, is open to you. If you don't use any of the selection criteria above, you can include all voters in your list.&#x20;

## <mark style="color:purple;">How do I reach the people on my list?</mark>&#x20;

There are several options.

* Use our [is\_address\_in\_marketing\_list](https://deepdao.gitbook.io/deepdao-products/governance-list-the-top-daoists/api-documentation) call to check if an address is included in your list.
* Use DeepDAO’s platform to contact these people (addresses) directly through notifications, or banners. Please write to us at <info@deepdao.io> for more information.
* Use any of the address to address chat apps, or address to address mail apps (you can find some of them in [DeepDAO’s Tools dashboard](https://deepdao.io/dao_tools)) to contact your target audience directly.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://deepdao.gitbook.io/deepdao-products/governance-list-the-top-daoists/how-to-use-our-top-people-api.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.