Website Contacts API

Live scrape of a company’s public website. Fetches the homepage and, when linked, a same-origin contact or about page. Returns addresses published on those pages — mailto, tel, JSON-LD people, and social profile URLs. It does not log in, crawl the whole site, or buy a third-party lead database. See the product page and website contacts use case.

Endpoint

GET /v1/contacts · 10 credits

curl -G https://api.clair.im/v1/contacts \
  -H "Authorization: Bearer YOUR_KEY" \
  --data-urlencode "domain=stripe.com"

Parameters

Parameter	Required	Contract
`domain`	yes	Public hostname, with or without `https://`. IPs and localhost are rejected.

Response

{
  "domain": "acme.com",
  "pages": ["https://acme.com/", "https://acme.com/contact"],
  "emails": ["hello@acme.com"],
  "phones": ["+1 415 555 0100"],
  "social": [
    { "network": "linkedin", "url": "https://www.linkedin.com/company/acme", "source_url": "https://acme.com/" },
    { "network": "twitter", "url": "https://x.com/acme", "source_url": "https://acme.com/" }
  ],
  "contacts": [
    {
      "name": "Ada Lovelace",
      "role": "Founder",
      "email": "ada@acme.com",
      "phone": null,
      "source_url": "https://acme.com/"
    }
  ]
}

Noreply and placeholder addresses are dropped. Social share buttons are not returned as profiles. Named contacts[] appear when JSON-LD or mailto labels exist.

What this API does not do

It does not crawl every path on the domain.
It does not resolve people from paid data brokers.
It does not fetch a caller-supplied arbitrary URL outside the domain parameter.

Auth, credits, and error codes: Authentication.

​Endpoint

​Parameters

​Response

​What this API does not do

Endpoint

Parameters

Response

What this API does not do