[ docs ]People

Contacts

A person's verified work email and mobile number, by LinkedIn handle. This is the tool for "how do I reach this person": ops: reveal (up to ten people by /in/ handle or profile URL; reveal=["email","phone"] by default, ["email"] alone when the number is not needed — a phone costs about five emails' worth). The handle must come from EVIDENCE: web-search the person, or find them with linkedin searchPeople, and use the /in/ you SAW — a handle typed from a name bills real credits and can reveal a DIFFERENT person's number. A reveal is YOUR org's asset: a part you already own is free, a part with nothing on file is answered once and never bought again, and nothing revealed is ever shared with another org. Batch subjects inside one call; estimate_only=true quotes without spending.

POST https://api.zomler.com/api/v1/platforms/contacts

reveal

reveal

from 105 credits

Work email and mobile number for up to ten people, by LinkedIn /in/ handle or profile URL. A reveal is the BUYER'S asset: billed per person and per part, owned by your org, never shared with another org. A part you already own is free; only the missing part is bought.

Request fields

Field	Type	Default	Values / limits
`subjects`required	list of string	—	1-10 items
`reveal`◆	list of enum	`['email', 'phone']`	`emailphone`

Example

curl

curl -X POST https://api.zomler.com/api/v1/platforms/contacts \
  -H "X-API-Key: zk_live_…" \
  -H "Content-Type: application/json" \
  -d '{
  "request": {
    "op": "reveal",
    "subjects": [
      "example"
    ]
  },
  "estimateOnly": false
}'

JavaScript

const res = await fetch("https://api.zomler.com/api/v1/platforms/contacts", {
  method: "POST",
  headers: {
    "X-API-Key": process.env.ZOMLER_API_KEY,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "request": {
      "op": "reveal",
      "subjects": [
        "example"
      ]
    },
    "estimateOnly": false
  }),
});
const envelope = await res.json();
console.log(envelope.data, envelope.cost.creditsCharged);

Python

import os, httpx

res = httpx.post(
    "https://api.zomler.com/api/v1/platforms/contacts",
    headers={"X-API-Key": os.environ["ZOMLER_API_KEY"]},
    json={
      "request": {
        "op": "reveal",
        "subjects": [
          "example"
        ]
      },
      "estimateOnly": False
    },
    timeout=120,
)
envelope = res.json()
print(envelope["data"], envelope["cost"]["creditsCharged"])