Preview people showing intent across multiple topics (free sample)

post

https://api.delivr.ai/api/v1/intent/people/multi/preview

Free, capped multi-topic preview of the person-grain direction: given up to 25 topic_ids, return a small sample (up to 25) of the top people (as HEMs), merged one row per person and annotated with which of the requested topics they matched, plus the total count of matching people. The merged (group_by=entity) shape is forced. Use it to show a teaser while configuring a source, then call the paid /api/v1/intent/people/multi to pull and pay for the full list.

Nothing is billed. It does not paginate (no cursor, no next_cursor) and never returns raw email; you always get the strongest-intent top of the merged list. Only floor filters are accepted; group_by, per_topic_limit, page_size, cursor, and resolve are not part of this request.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

Preview request for the multi-topic topic->people direction. Only the topics and floor filters are accepted; the merged (group_by=entity) shape is forced and the response is a hard-capped top-N sample, so group_by, per_topic_limit, page_size, and cursor are not part of this request (any such fields sent are ignored).

topic_ids

array of strings

required

length between 1 and 25

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

topic_ids*

min_score

string

enum

Minimum intent tier applied to each topic.

Allowed:

min_perc_score

integer

0 to 99

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

min_topics

integer

≥ 1

Keep people matching at least this many of the requested topics (default 1 = union).

resolve

boolean

When true, each merged person additionally carries masked_email (first character + domain) alongside the hem. The raw, unmasked email is available only via the paid /api/v1/intent/people/multi. Default false.

resolve_linkedin

boolean

When true, include masked_linkedin_url for each person we hold a LinkedIn profile for. Off by default, and independent of resolve. The value is masked to the first character of the profile slug, so it is not an actionable identifier: what it tells you is presence. A person with the field is LinkedIn-resolvable and one without is not, so reading it across the sample gives you the LinkedIn coverage of the audience before you import it. The unmasked URL is available only on the paid endpoints via resolve_linkedin.

Responses

Language

Credentials

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200A capped, unbilled sample of people across the requested topics. With resolve=true, each person also carries a masked_email alongside the hem.

400Invalid request: missing email or domain, empty items, more than 10,000 items, or a malformed body.

401Missing or invalid API credentials.