💡How to use our Top People API?

Overview

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:

Selection Criteria

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.

Which addresses are eligible to be in my list?

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.

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.

How do I reach the people on my list?

There are several options.

• Use our is_address_in_marketing_list 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 [e-mail] 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) to contact your target audience directly.