API reference

Contact enrichment

POST /v1/contacts/enrich — find a real, grounded contact at a company.

Enrich a contact

POST /api/v1/contacts/enrich

Finds the named role at a company and grounds their real email from public sources. Emails are verified and confidence-scored — never pattern-guessed. Counts against your monthly enrichment quota (429 when exhausted).

Body:

company — required, max 120 chars
role — required, e.g. "VP of Sales", max 120 chars
domain — optional hint, max 120 chars

curl https://www.artemise.live/api/v1/contacts/enrich \
  -H "Authorization: Bearer ns_live_..." \
  -H "Content-Type: application/json" \
  -d '{"company": "Acme", "role": "VP of Sales"}'

Response:

{
  "object": "contact",
  "name": "Jane Doe",
  "first_name": "Jane",
  "last_name": "Doe",
  "title": "VP of Sales",
  "email": "jane@acme.com",
  "email_source": "https://acme.com/team",
  "linkedin_url": "https://linkedin.com/in/janedoe",
  "domain": "acme.com",
  "confidence": "high"
}

email is null when no address could be proven — that's a feature: sending to guessed addresses burns your domain reputation.

This endpoint scrapes live sources and can take up to 60 seconds.

← Signals Drafts →