Preview people showing intent on a topic (free sample)

post

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

Free, capped preview of the person-grain topic direction: given a
topic_id, return a small sample (up to 25) of the top people (as HEMs),
ranked by perc_score, plus the topic's total count. Use it to show a
teaser while configuring a source, then call the paid /api/v1/intent/people
to pull and pay for the full list.

Nothing is billed. Distinct from dry_run (which returns a cost count and no
records): this returns actual sample records. It does not paginate (no
cursor, no next_cursor) and never returns seen_email; you always get the
strongest-intent top of the list. count is the topic's full people total,
so the sample is only a window onto it.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

Preview request for the topic->people direction. Only the topic, floor filters, and resolve are accepted: preview returns a hard-capped top-N sample and does not paginate, so page_size, cursor, and dry_run are not part of this request (any such fields sent are ignored).

topic_id

string

required

The topic to preview people for.

min_score

string

enum

Minimum intent tier. high returns only high-intent people; omit or medium returns all.

Allowed:

min_perc_score

integer

0 to 99

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

resolve

boolean

When true, each person additionally carries masked_email (first character + domain, e.g. j***@acme.com) alongside the hem, for recognition while validating an audience. The raw, unmasked email is available only via the paid /api/v1/intent/people. 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 the topic's people. With resolve=false the default hem-bearing shape; with resolve=true, hem plus a masked_email per person.

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

401Missing or invalid API credentials.