People showing intent across multiple topics

Multi-topic person-grain discovery: given up to 25 topic_ids in one
call, return the people (as HEMs) showing intent across them. The fan-out
runs in parallel server-side, so a 25-topic request is about as fast as a
single topic. Each HEM is a deterministic match key (sha256 of a
normalized email); raw emails are never returned.

group_by selects the response shape:

  • entity (default): one row per person, annotated with which of the
    requested topics they show intent on (topics) and how many they
    matched (topic_count). Set min_topics to require a match across at
    least N of the topics (default 1 = union). This view is
    cursor-paginated.
  • topic: the raw per-topic ranked lists, one bucket per requested
    topic.

min_score and min_perc_score filter each topic's results.
per_topic_limit (default 1000, max 5000) caps how deep each topic is
scanned. min_topics, page_size, and cursor apply only to
group_by=entity.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params
topic_ids
array of strings
required
length between 1 and 25

The topics to discover people across (1-25, deduped).

topic_ids*
string
enum

Minimum intent tier applied to each topic.

Allowed:
integer
0 to 99

Drop people below this percentile score in a topic. 0 or omitted keeps all.

string
enum

Response shape: entity (default) merges to one row per person; topic returns raw per-topic lists.

Allowed:
integer
1 to 5000

How deep each topic is scanned (default 1000, max 5000). One bounded Query per topic, so this stays a single round trip.

integer
≥ 1

group_by=entity only: keep people matching at least this many of the requested topics (default 1 = union).

integer
1 to 1000

group_by=entity only: people per page (default 50, max 1000).

string

group_by=entity only: opaque pagination cursor from a prior response's next_cursor.

Responses

Language
Credentials
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json