REST: GET /api/mcp/people/preview

Preview returns real matching records with the identity masked. It is how an agent proves a segment is the right one without spending a credit.

curl -G -H "Authorization: Bearer ag_live_..." \
  --data-urlencode "title=CFO" \
  --data-urlencode "country=Germany" \
  --data-urlencode "limit=10" \
  https://app.argorant.com/api/mcp/people/preview

Parameters

Every filter from the count endpoint applies, plus limit for how many rows to return.

What a row contains

A masked identity string rather than the full name.
Job title, company and country, so you can judge fit.
No email address, phone number or LinkedIn URL. Those appear only after a reveal or in an export.

The response also carries the total population behind the preview, so one call gives you both the size and a sample of the shape.

Preview response showing masked names with titles and companies

The CLI equivalent prints the same data in a readable form:

npx argorant search "CFO" --country Germany -n 10

Masked previews do not deduct contact credits and remain subject to quotas and rate limits. Inspect a small sample before approving paid output so you can correct the target roles or market first.