Preview people showing intent on a topic (free sample)

Free, capped, masked preview of the person-grain topic direction: given a topic_id, return a small sample (up to 25) of the top people, one row per person, ranked by perc_score, plus count, the number of people on the topic who match min_score and min_perc_score. Each row shows the person's company_name, department and seniority_band with intent; hem is null and no row carries a name, title, contact field or person key. field_coverage counts how many people in the sample hold each field the paid pull returns. Use it to judge a topic's people before you call the paid /api/v1/intent/people to pull and pay for the list.

Like the paid endpoint's, count covers every person on the topic who matches.

Nothing is billed. Distinct from dry_run (which returns a cost count and no rows): this returns masked sample rows. It does not paginate (no cursor, no next_cursor); you always get the strongest-intent top of the list. resolve and resolve_linkedin apply only to partner organizations enabled for the raw hem; the masked preview ignores them. count is every person who matches the request's min_score and min_perc_score, so the sample is only a window onto it.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params

Preview request for the topic->people direction. Only the topic and floor filters are accepted: preview returns a hard-capped, masked 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). resolve and resolve_linkedin apply only to partner organizations enabled for the raw hem; the masked preview ignores them.

boolean

Partner organizations enabled for the raw hem only; the masked preview ignores it. When true, each person also carries masked_email (first character + domain). The raw email is available only via the paid /api/v1/intent/people. Default false.

boolean

Partner organizations enabled for the raw hem only; the masked preview ignores it. When true, each person we hold a LinkedIn profile for also carries masked_linkedin_url. Independent of resolve. Default false.

string
required

The topic to preview people for.

You can send a topic ID that was merged into another topic. The topic that replaced it answers. topic_id in the response keeps the ID you sent, and resolved_topic_id names the answering topic.

An ID the API cannot use never causes an error. It returns no results and adds an entry to the response warnings array.

string
enum

Minimum intent tier. high returns only high, medium returns high+medium, and omitting it or low returns all.

Allowed:
integer
0 to 99

Drop people below this intent strength rating. 0 or omitted keeps all.

Responses

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