REST: GET /api/mcp/people/preview - Argorant Help

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://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

Previews are free and unlimited. There is no quota reason to skip this step, and skipping it is the most common cause of an expensive mistake: revealing 500 rows of a segment that was never right.